# Web Search + Read Top Pages

> Web Search + Read Top Pages is a paid API for AI agents from web.tollkit.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Performs a web search and returns full page text of the top 1–3 results, fetched in a real browser, in a single API call

## Facts

- Endpoint: POST https://web.tollkit.dev/search/read?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/web-search-read-top-pages-3100e2f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__73JFXTUXvrayySgVI1Q7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability web-search-read-top-pages-3100e2f2 -d '<json body>'
```

Example prompt: Search the web for 'best open-source LLM frameworks 2025' and read the full text of the top 3 results so I can get a comprehensive up-to-date picture.

## When to prefer this

Choose this endpoint when you need both a web search and full page text in a single call — ideal for RAG pipelines, research agents, or any task needing fresh, live web content without chaining separate search and scrape steps. Prefer it over a plain search API when the snippet is not enough and you need the complete page body. Prefer it over a standalone web scraper when you don't already have a URL and need discovery plus extraction together.

## Known failure modes

- Query exceeds 400-character limit — validation error returned
- Requested page is paywalled or JavaScript-heavy and cannot be fully extracted
- Search returns no results for highly niche or misspelled queries
- Country code is invalid or unsupported — pattern validation error
- Page read times out for slow-loading sites
- Payment fails or USDC balance is insufficient — x402 payment error

## How this service works

Web search that reads the results: give a query, get the top web results plus the full text of the top 1-3 pages, each read in a real browser. For research, RAG and fresh answers in one call.

## Output

Returns top web search results along with the full extracted text of 1–3 pages as fetched by a real browser, giving both link metadata and readable page content in a single response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "num": {
   "type": "integer",
   "default": 3,
   "maximum": 3,
   "minimum": 1,
   "description": "How many pages to read."
  },
  "query": {
   "type": "string",
   "maxLength": 400,
   "description": "What to search for."
  },
  "country": {
   "type": "string",
   "pattern": "^[a-zA-Z]{2}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "what is the x402 payment protocol",
  "answer": null,
  "source": "Web search via Tavily (tavily.com); pages read by Tollkit in a real browser",
  "results": [
   {
    "url": "https://www.x402.org/",
    "date": null,
    "page": {
     "text": "x402 is an open, internet-native payment standard … (full visible text of the page, up to 12,000 characters)",
     "title": "x402",
     "final_url": "https://x402.org/",
     "truncated": false,
     "fetched_at": "2026-10-04T12:00:00.000Z",
     "text_length": 3554
    },
    "title": "x402",
    "snippet": "An open standard for internet-native payments over HTTP 402.",
    "position": 1
   },
   {
    "url": "https://docs.cdp.coinbase.com/x402/welcome",
    "date": null,
    "page": {
     "text": "(full visible text of the page)",
     "title": "Welcome to x402",
     "final_url": "https://docs.cdp.coinbase.com/x402/welcome",
     "truncated": false,
     "fetched_at": "2026-10-04T12:00:01.000Z",
     "text_length": 6120
    },
    "title": "x402 overview",
    "snippet": "How x402 lets APIs charge per request in stablecoins.",
    "position": 2
   }
  ],
  "pages_read": 2,
  "searched_at": "2026-10-04T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/web-search-read-top-pages-3100e2f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from web.tollkit.dev](https://www.zero.xyz/host/web.tollkit.dev/llms.txt)