{"name":"web-search","description":"Live web search and web answer engine retrieval API for agents that need ranked sources before writing an answer. Send a query and optional recency filter; receive ranked web results with title, URL, snippet, and domain, not an LLM-written response. Successful results are cached, and provider rate limits trigger a short circuit breaker plus a clearly marked recent public-news fallback. Use it as a web answer engine source API, live web search API, web search MCP tool, RAG source-discovery feed, or source search tool. For fetched page text or cited synthesis, use answer-web or scrape-to-json.","price":"$0.006","method":"POST","input_schema":{"properties":{"query":{"type":"string","description":"Search query or research question. 1-500 chars."},"num_results":{"type":"number","description":"Number of results to return. Default 10, max 20."},"limit":{"type":"number","description":"Alias for num_results. If both are supplied, num_results wins."},"include_text":{"type":"boolean","description":"Accepted for compatibility. This route always returns ranked result metadata with include_text: false; use scrape-to-json for page text."},"recency":{"type":"string","enum":["day","week","month","year","any"],"description":"Optional freshness filter. Default 'any'."}},"required":["query"]},"input_example":{"query":"x402 payment protocol examples","num_results":10,"recency":"month"},"output_example":{"query":"x402 payment protocol examples","results":[{"title":"x402 documentation","url":"https://example.com/x402","snippet":"Pay-per-request protocol examples...","domain":"example.com"}],"source":"GDELT public-news fallback","source_url":"https://www.gdeltproject.org/","degraded":true,"include_text":false,"note":"Primary web search was unavailable; returned recent public-news results instead."},"x402_payment_required":true,"x402_facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}