# Pocket Network Web Search

> Pocket Network Web Search is a paid API for AI agents from agent.pocket.network, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-03).

Performs a live web search for a given query and returns structured JSON results, served over the Pocket Network decentralised infrastructure with pay-per-request USDC pricing.

## Facts

- Endpoint: POST https://agent.pocket.network/v1/agentsearch-web-search-v1?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pocket-network-web-search-82d874d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QsvScAOjdoqkdCjiGnGQx

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 pocket-network-web-search-82d874d7 -d '<json body>'
```

Example prompt: Search the web for the latest developments in quantum computing and give me up to 10 results.

## When to prefer this

Choose this endpoint when your agent needs live, real-time web search results without setting up an account or API key, and when paying per-request in USDC via x402 is acceptable. It is ideal for serverless or decentralised agent pipelines that need ad-hoc web search capability. Prefer it over managed search APIs when you want no credential management overhead and are already operating within the Pocket Network ecosystem.

## Known failure modes

- Query missing — returns 400 or validation error
- Payment not included or insufficient USDC — returns 402 Payment Required
- max_results set below minimum of 1 — returns validation error
- Network or upstream search provider timeout — may return 503 or empty results
- Ambiguous or very short query — returns low-quality or zero results

## How this service works

Web search built for agents, served over Pocket Network: POST /v1/search with a query and an optional max_results, and get the results back as one JSON object. Results vary run to run, as web search does. GET /v1/version, /v1/health and /v1/capabilities describe the service. Pay per request in USDC; no account, no API key.

## Output

A single JSON object containing an array of web search results, each typically including a title, URL, and snippet or summary of the matched page. The number of results is bounded by max_results if supplied. Results may vary between runs due to the live nature of web search.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "The search query, in natural language or keywords."
  },
  "max_results": {
   "type": "integer",
   "minimum": 1,
   "description": "How many results to return at most."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": "Pocket Network"
  },
  "portal": {
   "serviceId": "agentsearch-web-search-v1",
   "provenance": "third-party-supplier",
   "schemaCheck": "passed"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pocket-network-web-search-82d874d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.pocket.network](https://www.zero.xyz/host/agent.pocket.network/llms.txt)