# Search MethodShop tech how-to articles with Dappier's API Dappier's publisher search returns MethodShop tech guides, how-tos and digital lifestyle articles for a device or app question, ranked by relevance or by what is trending. Each query costs $0.003 and draws on prepaid credit, so a small credit bought without registering covers more than one query. Send `POST https://agents.dappier.com/zcj/f028cj1i5jfb/zeroclick/v2/search` with MethodShop's `data_model_id`, a `query` and a `search_algorithm`, and put a receipt or bearer credential in `Authorization`. ## At a glance - **Endpoint:** `POST https://agents.dappier.com/zcj/f028cj1i5jfb/zeroclick/v2/search?data_model_id=dm_01jh3jg18fe92v4az2h2163t8k` - **Body:** `query` (required: a question, keyword or URL), `search_algorithm` (`semantic`, `trending`, `most_recent` or `most_recent_semantic`), `similarity_top_k` (number of articles) - **Price per query:** $0.003 - **Payment:** each query draws on Prepaid credits. Send `Authorization: Receipt ` from a small credit bought without registering, or `Authorization: Bearer ` for a credential that holds Prepaid credits. - **Response:** JSON with `status` and `response.results`, a list of articles with `title`, `url`, `summary`, `preview_content`, `pubdate` and `score` - **Billing header:** `zc-billing` reports `chargedUsd` and `remainingCreditUsd` for each query - **Full purchase flow:** [the buyer skill](https://agents.dappier.com/zcj/f028cj1i5jfb/SKILL.md) ## Search MethodShop's tech how-to articles 1. Have credit behind the call. This route has no per-call price quote. Calls draw on a balance, so hold one of these: ``` Authorization: Receipt Authorization: Bearer ``` A receipt comes from a small credit bought without registering. A bearer is the agent identity the storefront issues, and it holds a Prepaid credits balance. [The buyer skill](https://agents.dappier.com/zcj/f028cj1i5jfb/SKILL.md) covers getting either one. 2. Send the search with MethodShop's `data_model_id` and an explicit `search_algorithm`: ```bash curl -si -X POST "https://agents.dappier.com/zcj/f028cj1i5jfb/zeroclick/v2/search?data_model_id=dm_01jh3jg18fe92v4az2h2163t8k" \ -H "Authorization: Receipt $RECEIPT_ID" \ -H "Content-Type: application/json" \ -d '{"query": "how to back up an iPhone", "search_algorithm": "semantic", "similarity_top_k": 3}' ``` 3. Read the articles from `response.results`. The body has this shape: ```json { "status": "", "response": { "query": "", "message": "", "results": [ {"title": "", "url": "", "summary": "", "preview_content": "", "author": "", "pubdate": "", "pubdate_unix": 0, "score": 0, "site": "", "site_domain": "", "source_url": "", "image_url": ""} ] } } ``` Answer from `summary` or `preview_content`, and link the reader to `url`. `score` is the relevance score. `pubdate` is the publication date. 4. Check what the query drew. The `zc-billing` response header has this shape: ``` zc-billing: {"status":"settled","fundingSource":"credit","chargedUsd":"","remainingCreditUsd":""} ``` The example request above returns three results with these fields, plus a numeric `content_id`, and draws $0.003 from the receipt, which keeps the rest of its balance for the next query. 5. Refine and search again with the same credential. A narrower question or a different `search_algorithm` is one more query at $0.003. Two queries cost $0.006 and three cost $0.009. ## Choose how results are ranked Set `search_algorithm` on every request. | You want | `search_algorithm` | | --- | --- | | Articles that answer a specific question | `semantic` | | Articles matching keywords trending in the past 24 hours | `trending` | | The newest articles by publication date | `most_recent` | | Relevant articles, newest first | `most_recent_semantic` | A `query` can also be a page URL. The search then works from that page's content and returns related articles. ## Charges and limits - Each successful search is billed as one query. A call with no credential is refused with `401`. - A delivered response with no `zc-billing` header billed nothing. - One request searches one data model. There is no batch parameter. A second question is a second request. - Results carry a `summary`, a short `preview_content` and the article `url`. - A receipt spends only its own balance and cannot be topped up. Losing the receipt loses its remaining credit. ## Errors | Response | Meaning | Action | | --- | --- | --- | | `401 bearer_required` | The call carried no credential | Send a receipt or bearer in `Authorization` | | `401 invalid_receipt` | The storefront cannot use the receipt: a bad format, an unfinished purchase, a revoked receipt, or one issued for a different seller | Send only the `receiptId` from a successful credit purchase | | `402 receipt_credit_exhausted` or `receipt_credit_insufficient` | The receipt's balance cannot cover a query | Get a new receipt or Prepaid credits through [the buyer skill](https://agents.dappier.com/zcj/f028cj1i5jfb/SKILL.md) | | `403 plan_required` | The bearer holds no plan that covers the query | Buy Prepaid credits, then retry | | `usage_exhausted` | The Prepaid credits balance is used up | Top up with `POST https://agents.dappier.com/zcj/f028cj1i5jfb/extend` | | `400` `data_model_id is required` | The query parameter is missing | Add MethodShop's `data_model_id` to the URL | | `422` `query cannot be empty` | The body had no `query` | Send a non-empty `query` | ## Frequently asked questions ### Is there an API for MethodShop tech how-to articles? Yes. Dappier's storefront serves MethodShop's tech guides and how-tos through `POST https://agents.dappier.com/zcj/f028cj1i5jfb/zeroclick/v2/search` with `data_model_id=dm_01jh3jg18fe92v4az2h2163t8k`. It returns ranked articles with titles, summaries, previews and links. ### How much does a MethodShop query cost? $0.003, drawn from prepaid credit. The smallest Prepaid credits purchase on a wallet rail is $0.01. A new card-funded purchase starts at $0.50, and the unused balance stays as credit for later queries. ### Can I search MethodShop without registering? Yes: a small credit bought without registering gives a receipt to send as `Authorization: Receipt `, and [the buyer skill](https://agents.dappier.com/zcj/f028cj1i5jfb/SKILL.md) covers getting it. ### Which search_algorithm suits a support question? Use `semantic` for a specific question, such as backing up a phone. Use `trending` for articles tied to keywords trending in the past 24 hours. ### What happens when the receipt runs out? The search answers `402` with `receipt_credit_exhausted` or `receipt_credit_insufficient`. Buy a new receipt, or move to Prepaid credits with a bearer and top them up with `POST https://agents.dappier.com/zcj/f028cj1i5jfb/extend`. ## Keep reading - [The buyer skill](https://agents.dappier.com/zcj/f028cj1i5jfb/SKILL.md): the full purchase flow - [How to pay](https://agents.dappier.com/zcj/f028cj1i5jfb/payment.md): receipts, Prepaid credits and the payment rails - [Error reference](https://agents.dappier.com/zcj/f028cj1i5jfb/errors.md): every error code and the action to take - [API reference](https://agents.dappier.com/zcj/f028cj1i5jfb/openapi.json): the request and response schema --- Updated 2026-10-16. All Dappier guides: https://agents.dappier.com/guides.md. Storefront: https://agents.dappier.com/zcj/f028cj1i5jfb/llms.txt.