{"uid":"cap_iaWrnq8TzwyuR02_Y-2Y6","slug":"crypto-web-data-api-web-search-59b74b58","name":"Crypto & Web Data API – Web Search","description":"Web search for agents: up to 20 organic results with title, URL, snippet and domain, no ads. Pair with /api/v1/fetch to read a result as Markdown.","url":"https://api.agent-data.workers.dev/api/v1/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search query"},"limit":{"type":"integer","maximum":20,"minimum":1},"region":{"type":"string","description":"e.g. us-en, de-de (optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"query":"x402 payment protocol","engine":"duckduckgo","results":[{"url":"https://www.x402.org/","rank":1,"title":"x402 - payments over HTTP","domain":"x402.org","snippet":"An open protocol for internet-native payments..."}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2avf0HOgKidSnYw0Zjy_1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns up to 20 organic web search results (title, URL, snippet, domain) for a given query, ad-free, powered by DuckDuckGo.","exampleAgentPrompt":"Search the web for 'x402 payment protocol overview' and give me the top 10 organic results with their titles, URLs, and snippets — no ads, US English region.","exampleUseCases":[{"title":"Research a crypto protocol","prompt":"Search the web for 'ERC-4337 account abstraction explained' and show me the top 5 results with titles and snippets so I can find the best documentation to read."},{"title":"Find a company's official presence","prompt":"Look up 'Coinbase official website' on the web and return the top 3 organic results so I can confirm the real domain and description."},{"title":"Discover DeFi news and articles","prompt":"Search for 'Uniswap v4 launch' and return up to 15 results with titles, URLs, and snippets — use the US English region."}],"resultDescription":"A JSON object containing the search query, engine name ('duckduckgo'), total result count, and an array of up to 20 results each with: rank (integer), title (string), url (string), domain (string), and snippet (string). Results are organic only — no ads or sponsored listings.","failureModes":["Missing required 'q' parameter returns a validation error","Limit value outside 1–20 range is rejected","Invalid region code may return no results or fall back to default","Query with no matching results returns an empty results array","Upstream DuckDuckGo rate-limiting or downtime causes 5xx errors","Payment not received (x402) results in 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need clean, ad-free organic web search results with structured metadata (title, URL, snippet, domain, rank) suitable for further processing. It is ideal when you want to pair search with /api/v1/fetch to read result pages as Markdown, or when you need regional search results. Prefer this over news-specific endpoints when you want broader web coverage beyond recent headlines, and over direct URL fetching when you don't yet know which URLs to visit.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T17:29:42.267Z","isFirstParty":false,"canonicalSlug":"crypto-web-data-api-web-search-59b74b58"}