# ReadFetch Web Search

> ReadFetch Web Search is a paid API for AI agents from readfetch.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-03).

Performs a web search and returns titles, URLs, and snippets without requiring a search subscription

## Facts

- Endpoint: POST https://readfetch.com/v1/search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readfetch-web-search-4d4b0e24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yhv_sIRVB74RI8O7CeNTR

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 readfetch-web-search-4d4b0e24 -d '<json body>'
```

Example prompt: Search the web for the latest news about OpenAI's new model releases from the past week and give me up to 10 results with titles and links.

## When to prefer this

Choose this endpoint when an AI agent needs to perform live web searches without holding a subscription to a search provider like Google or Bing. It is particularly well-suited for agents that need fresh, time-filtered results (e.g. past hour or week), multilingual search, or need to avoid datacenter IP blocks via residential egress. At $0.005 per call it is cost-effective for occasional lookups. Prefer it over scraping endpoints when you want a ranked list of relevant URLs rather than the full content of a known page.

## Known failure modes

- Query too short or empty — validation error returned
- Requested limit outside 1-20 range — schema validation failure
- Invalid time-range enum value — error response
- Target blocks datacenter IP and residential egress not requested — empty or degraded results
- Network or upstream search provider failure — 5xx error

## How this service works

Run a web search without a separate search API subscription. Returns titles, URLs, and snippets only — not full page text; follow with readfetch_text, readfetch_probe, or readfetch_scrape on a chosen result URL. `limit` is 1–20 (default 5). Optional `lang` biases locale (e.g. en, de-DE). Optional `tbs` filters recency: h= past hour, d= day, w= week, m= month, y= year. Use readfetch_map/readfetch_crawl when you already know the site; readfetch_* URL tools when you have the lin

## Output

An ordered list of web search results, each containing a page title, URL, and a short text snippet. Results are limited to the number requested (default 5, max 20) and may be filtered by time range (hour, day, week, month, year) and language.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tbs": {
   "anyOf": [
    {
     "enum": [
      "h",
      "d",
      "w",
      "m",
      "y"
     ],
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "description": "Optional recency filter: h=hour, d=day, w=week, m=month, y=year."
  },
  "lang": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "description": "Optional language/locale hint, e.g. en or de-DE."
  },
  "limit": {
   "type": "number",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "Maximum number of results to return (default 5)."
  },
  "query": {
   "type": "string",
   "minLength": 1,
   "description": "Search query string."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readfetch-web-search-4d4b0e24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from readfetch.com](https://www.zero.xyz/host/readfetch.com/llms.txt)