Web search via Google, formatted for AI agents

Send a query, get back deduplicated Google results with snippets, relevance scores, and related questions. No API key, no account — pay $0.010 USDC per call via x402.

$0.010 USDC / call free trial: 5/day per IP contabo

Endpoint

POST https://contabo-vps.taild7e69a.ts.net/websearch/api/websearch

Data source: Google Search via Serper (normalized, deduplicated, spam-filtered)

Parameters

Param	Type	Description
`query`	string (body JSON)	Search query, e.g. x402 protocol
`num`	number, optional	Max results 1-20, default 10
`country`	string, optional	Localization, e.g. us, vn (default us)
`type`	string, optional	search, news or images (default search)

Example request

curl -X POST "https://contabo-vps.taild7e69a.ts.net/websearch/api/websearch" \
  -H "Content-Type: application/json" \
  -d '{ "query": "x402 protocol", "num": 5 }'

Example response

{
  "query": "x402 protocol",
  "resultCount": 5,
  "results": [
    {"title": "...", "url": "https://...", "snippet": "...",
     "domain": "example.com", "position": 1, "relevance": 100}
  ],
  "fetchedAt": "2026-10-18T12:00:00.000Z"
}

How payment works (x402)

Call the endpoint without any payment header → you get 402 Payment Required with the exact price, the USDC contract, the network (eip155:8453 = Base), and the pay-to address.
Pay 0.010 USDC on Base to the pay-to address — with any wallet, the Coinbase CDP x402 SDK, or any x402 client library.
Retry the same request with the X-PAYMENT header set to the base64-encoded signed payment payload → 200 with JSON.

# 1. Get the 402 payment requirements
curl -s -X POST "https://contabo-vps.taild7e69a.ts.net/websearch/api/websearch" -H "Content-Type: application/json" -d '{ "query": "x402 protocol", "num": 5 }'

# 2. Pay 0.010 USDC on Base, then retry with the payment proof
curl -X POST "https://contabo-vps.taild7e69a.ts.net/websearch/api/websearch" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64-signed-payment-payload>" \
  -d '{ "query": "x402 protocol", "num": 5 }'

Facilitators: Coinbase CDP and PayAI (no API key needed for either). Scheme: x402 v2 exact. Asset: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base.

Free trial

Every IP gets 5/day free calls to this endpoint — no payment needed. Free calls run automatically when you call without an X-PAYMENT header. The X-Free-Remaining response header shows how many free calls you have left today. When the quota is exhausted, the request falls through to the normal 402 payment flow.

FAQ

How is this different from raw SERP data?
Results are deduplicated by domain, spam-filtered, and relevance-scored — AI-ready, not a raw dump.

Which search types are supported?
Web, news, and image search via the type parameter.

Is there caching?
Identical queries are cached for 1 hour, but every call is still billed per the x402 payment.

Do I need an API key?
No. This API uses x402: call the endpoint, receive a 402 Payment Required with the price, pay in USDC on Base, and retry with the X-PAYMENT header. No signup, no API key, no account.

Which facilitators are supported?
Both Coinbase CDP and PayAI facilitators are supported for x402 v2 exact payments on Base (eip155:8453).

What if my payment is too low?
The facilitator verifies the on-chain amount against the price. If underpaid, you get 402 again; pay the full amount and retry.

All 37 x402 API docs · Postman collection (download) · About this API