{"name":"web-search","description":"Web search API for advanced agent web investigation and RAG source discovery. Returns ranked Google results with title, URL, snippet, domain, and an optional recency filter. Successful results are cached, and provider rate limits trigger a short circuit breaker plus a clearly marked recent public-news fallback. Use it as an advanced web investigation API, research retrieval layer, source discovery tool, or RAG ingestion feed. For fetched page text or cited answers, 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":"Whether to include fetched page text when the upstream supports it."},"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"}