# switch402 Web Search

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

Takes a search query string and returns up to 10 ranked web results (title, URL, snippet), charged per successful call via x402.

## Facts

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

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 switch402-web-search-a9a11559
```

Example prompt: Search the web for 'best open-source LLM frameworks in 2025' and give me the top 5 results with their titles and URLs.

## When to prefer this

Choose this endpoint when an agent needs live web search results with ranked titles, URLs, and snippets in a lightweight pay-per-success model. Ideal for agents that need current information beyond their training data, competitive research, or any task requiring fresh web sources. Prefer over scraping endpoints when you need ranked discovery across many pages rather than deep extraction of a known URL.

## Known failure modes

- Query string missing or empty — required parameter 'q' not provided
- Query exceeds 400 characters — will be rejected by schema validation
- Limit parameter out of range (must be 1–10)
- No results found for the query — may return an empty results list
- Payment failure via x402 protocol — call not executed
- Downstream search provider unavailable — service error returned

## How this service works

switch402 web search: a query in, up to 10 ranked results (title, URL, snippet) out. Charged only on success.

## Output

An ordered list of up to 10 web search results, each containing a page title, URL, and a short descriptive snippet. Results are ranked by relevance to the query. The response is only charged on success.

## 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",
       "maxLength": 400,
       "minLength": 1,
       "description": "Search query (1-400 characters)"
      },
      "limit": {
       "type": "integer",
       "maximum": 10,
       "minimum": 1,
       "description": "Max results (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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