AgentSearch

web

Serving

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.

Endpoint: POST https://agent.pocket.network/v1/agentsearch-web-search-v1
Price per call: $0.005 USD
Networks payable on: Base (eip155:8453)
Protocol: rest

Calling it

The first call returns 402 Payment Required with the terms. Sign for those terms and retry the same request with the payment attached.

Example request

Derived from the published request schema.

curl -X POST https://agent.pocket.network/v1/agentsearch-web-search-v1 \
  -H 'content-type: application/json' \
  -d '{"query":"string","max_results":0}'

Example response

Derived from the published response schema.

{
  "query": "Pocket Network"
}

Try it

Make one real paid call from your own wallet — about $0.005 on Base (eip155:8453). The wallet signs; nothing here holds a key. You'll see exactly what the service answers.

No browser wallet found. Install MetaMask, Rabby, or Coinbase Wallet to try a call here.

EndpointRequest body

Supported methods

Methods the registry lists for this service. The portal forwards any call as sent; the supplier decides what it answers, and a delivered answer is settled.

Methods AgentSearch accepts, and whether each reads or writes.
Method	Effect
`GET /healthz`	read
`GET /v1/capabilities`	read
`GET /v1/health`	read
`GET /v1/version`	read
`POST /v1/search`	read

Schemas

Published by the service itself. The example above is generated from these.

Request schema

{
  "type": "object",
  "description": "A search request. The body is JSON and is bounded by the service at 16 KiB.",
  "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."
    }
  },
  "required": [
    "query"
  ]
}

Response schema

{
  "type": "object",
  "description": "For POST /v1/search, a JSON object carrying the `query` as received and the search results; the exact shape is the service's own and is not pinned here. A validation failure returns `{ detail: [{ loc, msg, type }] }` with HTTP 422. The other routes (healthz, version, health, capabilities) return their own small JSON documents.",
  "examples": [
    {
      "query": "Pocket Network"
    }
  ]
}

Request body used in the example: { "query": "string", "max_results": 0 }