Web search API: search results for AI agents
Web search API for AI agents and apps: search results for a query, ready for agent consumption, for $0.005 USDC per call through x402 on Base. Cached results, no signup, no API key.
Endpoint
POST https://apisphere.us.ci/api/v1/web-search returns search results for a query, powered by DuckDuckGo Instant Answer and search APIs. A plain GET only advertises the x402 payment challenge - send data over POST.
- Price: $0.005 USDC per call, settled on Base through x402.
- Freshness: results cached for 15 minutes (NEAR_REAL_TIME).
- Results are limited to 1-10 per request (default 5).
Request fields
Send a JSON body. Invalid bodies return 400 with field-level details.
- query (required): 1 to 500 characters - the search query.
- limit (optional): integer from 1 to 10, defaults to 5.
curl -X POST https://apisphere.us.ci/api/v1/web-search -H "Content-Type: application/json" -H "X-PAYMENT: <signed-payment-payload>" -d '{"query": "latest AI developments"}'Response
A 200 response returns the query, an abstract, heading, and a results array with titles, URLs, and snippets, plus a meta block with the request id and latency.
- 400 - invalid query or limit (details in the response).
- 402 - missing or invalid payment.
- 429 - rate limited; honor Retry-After.
- 502 - upstream provider error; the same request is safe to retry.
{
"query": "latest AI developments",
"abstract": "AI refers to the simulation of human intelligence...",
"heading": "Artificial intelligence",
"results": [
{
"title": "Artificial intelligence",
"url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
"snippet": "Wikipedia: AI is the intelligence...",
"source": "DuckDuckGo"
}
],
"related_topics": ["Machine learning", "Neural networks"],
"meta": {
"cache": "miss",
"request_id": "7f3a9c2e-1b4d-4f6a-8c2e-9d1f5a3b7c4e",
"latency_ms": 142
}
}