# Web Search (x402.shizu.me)

> Web Search (x402.shizu.me) is a paid API for AI agents from x402.shizu.me, paid per call via x402, $0.012/call, status unknown (last checked 2026-10-02).

Performs a live web search and returns fresh results (title, URL, snippet) per query, requiring a small USDC micropayment per call via x402.

## Facts

- Endpoint: GET https://x402.shizu.me/search?utm_source=zero.xyz
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/web-search-x402-shizu-me-99fbc869
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7ZhOLlkixufTtdYkelRFH

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-x402-shizu-me-99fbc869
```

Example prompt: Search the web for the latest news on OpenAI's new model releases and give me the top 5 results including their titles, URLs, and snippets.

## When to prefer this

Choose this endpoint when your agent needs live, fresh web search results but does not have its own search API credentials (e.g. no Google Custom Search or Bing API key). It is ideal for pay-per-query scenarios where you want to avoid subscription overhead, or when building agents that need occasional web lookups without managing a search account. Prefer this over cached or static data sources when recency matters.

## Known failure modes

- Invalid or missing 'q' parameter returns an error
- Count outside 1-20 range may be rejected or clamped
- Invalid 2-letter country code may be ignored or return an error
- Payment failure (insufficient USDC or x402 auth issue) blocks the request
- Upstream search account rental failure may cause temporary unavailability
- Rate limits or abuse detection on the underlying search provider may return empty or degraded results

## How this service works

Live web search for agents that hold no search account. Query: q (required), count (1-20, default 10), country (2-letter, optional). Each result: title, url, snippet. Fresh per call — search is a poll, not a cache. One account rented per query.

## Output

Returns a list of up to 20 web search results, each containing a page title, URL, and a short snippet of relevant text. Results are fresh per call — not cached — reflecting the current state of the web at query time.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q",
      "count"
     ],
     "properties": {
      "q": {
       "type": "string"
      },
      "count": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10,
  "query": "x402 protocol",
  "results": [
   {
    "url": "https://…",
    "title": "…",
    "snippet": "…"
   }
  ],
  "provider": "brave"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/web-search-x402-shizu-me-99fbc869/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.shizu.me](https://www.zero.xyz/host/x402.shizu.me/llms.txt)