# serp402

Google search for agents, paid per call over x402 in USDC. No API key, no account, no subscription.

## Endpoint
POST https://serp402.com/api/v1/search — USD 0.005 per call.

Body: {"query": "what to search", "type": "search", "country": "us", "language": "en", "num": 10}
type is one of: search, news, images, videos, places, shopping, scholar. Also accepts "location" (city-level), "freshness"
(day|week|month|year) and "page".

Returns: Google's direct answer and knowledge-panel facts when it has them, plus results in one
shape whatever was searched — position, title, url, site, snippet, publishedAt (ISO),
publishedLabel, and an "extra" object with the fields that search type carries (price and seller
for shopping, address, rating and coordinates for places, publication and citedBy for scholar).
URLs are canonicalised and duplicates removed.

## How to pay
Call it. You get 402 with the price and the accepted networks (Base, Solana). Pay with an x402
client such as @x402/fetch and repeat the request. You are charged only when results are delivered:
if the upstream fails the payment is cancelled and the error says so.

## Other endpoints
GET https://serp402.com/api/status — what is configured and what it costs.
GET https://serp402.com/openapi.json — the schema.

## Where the data comes from
Google search results retrieved through Serper (serper.dev). Serper is not affiliated with or
endorsed by Google. Trademarks and copyright remain with their owners. Every response carries an
`attribution` object — keep it with the results if you pass them on.