# GET /search/answer: $0.03 per call

Search, read and summarise in one call (open-sources tier): finds pages via Wikipedia, Hacker News, DuckDuckGo and Stack Overflow, reads the top ones (robots.txt respected) and writes a concise cited answer, plus pages read and all results. Upgrades itself to full-web search (and price) when a premium index is connected. ?q=question&pages=3

- **Price:** $0.03 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** no, paid only (it uses a paid AI model or data source, or costs more than the trial covers). Try [search-open](/services/search-open) free instead. Other ways to pay: x402 or [prepaid credits](/credits).
- **Tier:** deep
- **Answers cached for:** 30 min
- **Data sources:** Open sources: Wikipedia, Hacker News, DuckDuckGo, Stack Overflow (free); The result pages themselves; Workers AI (metered)
- **Lane:** Web search and crawling ([OpenAPI](/openapi/web-search.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/search-answer](/sample/search-answer). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/search-answer"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/search/answer?q=What+is+the+HTTP+402+status+code+used+for%3F&pages=3"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/search/answer?q=What+is+the+HTTP+402+status+code+used+for%3F&pages=3");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("search-answer", {"q":"What is the HTTP 402 status code used for?","pages":3});
```

## Inputs

- `q` **(required)** (string): Question or topic to research.
- `pages` (integer; default `3`): How many top result pages to read (1-5).

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "query": "What is the HTTP 402 status code used for?",
  "answer": "HTTP 402 Payment Required was reserved for digital payments [1] and is now used by the x402 protocol for pay-per-call APIs [2].",
  "pagesRead": [
    {
      "n": 1,
      "title": "HTTP 402",
      "url": "https://en.wikipedia.org/wiki/HTTP_402",
      "read": true
    }
  ],
  "results": [
    {
      "title": "HTTP 402",
      "url": "https://en.wikipedia.org/wiki/HTTP_402",
      "snippet": "HTTP 402 Payment Required is a status code reserved for digital payment systems.",
      "source": "wikipedia",
      "publishedAt": "2026-09-01T10:00:00Z"
    }
  ],
  "provider": "open",
  "sources": [
    {
      "name": "wikipedia",
      "ok": true,
      "count": 1
    }
  ],
  "answeredAt": "2026-09-28T12:00:00.000Z"
}
```

## Related

- [GET /search/open](/services/search-open) ($0.002): Cheapest search: Wikipedia articles, Hacker News stories, DuckDuckGo instant answers and Stack Overflow questions in one call, merged, de-duplicated and ranked,
- [GET /search](/services/search) ($0.003): Live search, open-sources tier: fresh results from Wikipedia, Hacker News, DuckDuckGo instant answers and Stack Overflow, merged, de-duplicated and ranked (titl
- [GET /metadata](/services/metadata) ($0.002): A web page's metadata in one cheap call: title, description, canonical URL, language, site name, preview image, OpenGraph and Twitter card tags, author and date
- [GET /feed](/services/feed) ($0.003): Latest posts from any site or feed as clean JSON: pass a feed URL or just the site's address and we find its RSS, Atom or JSON Feed (from the page's links or co
- [POST /page/changes](/services/page-changes) ($0.002): Watch any public page for changes: we fetch it now (robots.txt respected), fingerprint its text and return a token.
- [POST /page/changes/summary](/services/page-changes-summary) ($0.008): Page change detection with an AI summary: like /page/changes (send back the token from your last check), plus a two-sentence summary of what changed and whether
- [GET /product](/services/product) ($0.003): Product and price from any public product page, as clean JSON: name, brand, price, currency, availability, condition, SKU/GTIN, seller, rating and image, read f
- [GET /product/ai](/services/product-ai) ($0.01): Product and price from any public product page, even without structured data: uses the page's schema.org/OpenGraph data when present, otherwise AI reads the pag

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).