# x402 Web Search

> x402 Web Search is a paid API for AI agents from x402tap.com, paid per call via x402, $0.015/call, status unknown (last checked 2026-10-12).

Real-time web search returning ranked results with title, URL, published date, author, and relevance score for a query, powered by Exa

## Facts

- Endpoint: GET https://x402tap.com/api/web-search?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-web-search-b8138f81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2a2nEFMGsVVT6hdBqa3xs

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 x402-web-search-b8138f81
```

Example prompt: Search the web for the latest developments in Base blockchain and give me the top 5 results with titles, URLs, and publication dates.

## When to prefer this

Choose this endpoint when you need real-time, ranked web search results with publication metadata (date, author, score) rather than cached or static data. It is preferable to a generic search API when relevance scoring and freshness signals matter — for example, when researching recent events, verifying claims with dated sources, or building an agent that needs to cite authoritative URLs. Its pay-per-call x402 pricing model ($0.003 USDC) makes it cost-effective for sporadic or on-demand searches without subscription commitments.

## Known failure modes

- Missing required 'q' parameter returns a 400 error
- numResults outside 1–10 range may be clamped or rejected
- Queries for very niche or non-indexed content may return low-relevance or zero results
- Payment failure (insufficient USDC balance) returns a 402 error
- Network timeouts from the upstream Exa provider may cause 503 errors

## How this service works

Real-time web search (via Exa) — ranked results with title, URL, published date, author, and relevance score for a query

## Output

A JSON object containing the original query, an array of up to 10 ranked results (each with URL, title, relevance score 0–1, published date, and author when available), and an optional autoprompt string. Results are ordered by relevance score descending.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search query"
      },
      "numResults": {
       "type": "integer",
       "description": "Number of results to return (1-10, default 5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "Base blockchain",
  "results": [
   {
    "url": "https://en.wikipedia.org/wiki/Base_(blockchain)",
    "score": 0.87,
    "title": "Base (blockchain) - Wikipedia",
    "author": null,
    "publishedDate": "2023-08-09"
   }
  ],
  "autopromptString": null
 }
}
```

## More

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