Home / API docs / Web Search API
Web Search

Web Search API

POST /api/search $0.01 per call USDC on Base · x402

WEB SEARCH for keyless agents — POST {query} and get LLM-ready results: title, url, extracted content snippet, relevance score, plus a direct answer synthesized from live results. Options: max_results (1-10, default 5), topic (general|news). No API key, no account — the x402 payment IS the auth. Query up to 400 chars.

Parameters

NameInDescription
querybodyrequiredThe search query, up to 400 characters
max_resultsbodyHow many results to return (1-10, default 5)
topicbodygeneral (default) or news

Example request

curl -X POST "https://api.webbersites.com/api/search" \
  -H "Content-Type: application/json" \
  -d '{"query":"x402 payment protocol adoption 2026","max_results":5}'
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "query": "x402 payment protocol adoption 2026",
    "answer": "The x402 protocol has seen growing adoption...",
    "results": [
        {
            "title": "x402.org",
            "url": "https://x402.org",
            "content": "An open protocol for internet-native payments...",
            "score": 0.97
        }
    ]
}
MCP tool: post_search — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.