# Open Web Search

> Open Web Search is a paid API for AI agents from x402-echo-service.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Performs keyword and semantic web search, returning ranked results with titles, URLs, and text snippets — no API key required, billed per call via x402.

## Facts

- Endpoint: POST https://x402-echo-service.onrender.com/web/search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/open-web-search-785f26f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f2ir4pHTRbP4-w2Ug-XJN

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 open-web-search-785f26f5 -d '<json body>'
```

Example prompt: Search the web for 'best practices for securing Node.js APIs' and return the top 5 results with titles and links.

## When to prefer this

Choose this endpoint when an agent needs to retrieve live web search results without requiring an API key or pre-negotiated credentials — ideal for lightweight, pay-per-call search in automated pipelines. It combines keyword and semantic matching, making it suitable for both precise and exploratory queries. Prefer this over scraping individual URLs when you need ranked, multi-source results in a single call.

## Known failure modes

- Empty or whitespace query returns a validation error
- Limit outside 1–20 range is rejected
- Query exceeding 512 characters is rejected
- Payment failure (x402) results in a 402 response with no results
- Upstream search index unavailable causes 5xx error
- Obscure or very niche queries may return low-quality or no results

## How this service works

Web search for agents. POST a JSON body with a "query" string and an optional "limit" (1-20); returns ranked results, each with a title, url and text snippet. Keyword and semantic matching, no API key required, billed per call: $0.001000 USDC.

## Output

An ordered list of up to 20 web search results, each containing a page title, a URL, and a text snippet extracted from the page — ranked by relevance to the query using keyword and semantic matching.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 512,
   "minLength": 1,
   "description": "Search query."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/open-web-search-785f26f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-echo-service.onrender.com](https://www.zero.xyz/host/x402-echo-service.onrender.com/llms.txt)
