Surf Web · Search and Crawl API
Query web search results with configurable result count (1-20). Returns title, URL, and snippet for each result.
What it does
Query web search results with configurable result count (1-20). Returns title, URL, and snippet for each result.
- Retrieve current web search results for a query
- Crawl web pages for content extraction
- Build search-augmented AI agents with live data
Ideal buyer
AI agents and developers needing real-time web search without subscription overhead.
Run this through your governed agent wallet.
- 01Bootstrap AXON once with
npx @axon402/init. - 02Use the AXON runtime MCP tools to
search_x402_servicesorinspect_x402_offerfor this service. - 03Quote, test-buy, then run the governed paid fetch through AXON.
Send this
Prompt for your agent
A natural-language instruction for your LLM agent — with this endpoint exposed as a tool — to call this resource. Not sent to the endpoint; the endpoint consumes the JSON body below.
Pasting this prompt into a raw ChatGPT or unconfigured agent will notexecute the paid endpoint flow. Run it through an agent with the AXON runtime / MCP tools exposed (see “Use with AXON” above) so the 402 challenge, quote, and governed fetch are handled for you.
“Search the web for 'latest Ethereum Layer 2 developments' and return 10 results”
Endpoint request body
The JSON payload your agent sends to the endpoint.
{
"query": "latest Ethereum Layer 2 developments",
"num_results": 10
}Advanced HTTP details
For integrators who need the raw protocol surface. Most agents should use AXON above instead of calling these directly.
Endpoint URL
curl fallback
curl https://web.surf.cascade.fyi/v1/search \ -H "Content-Type: application/json" \ -H "X-PAYMENT: [signed_payment_envelope]" \ -d '{"query":"latest Ethereum Layer 2 developments","num_results":10}'
Payment & settlement details
Raw on-chain settlement parameters. AXON above handles these automatically through quote / test-buy / governed fetch.
Price & network
Trust & risk
More in Data APIs
Browse all →Other resources in this category
Category proxy — we don't track live co-purchase signals yet.