{"uid":"cap_1ySVjBVRW9KHgQERA1L4d","slug":"agent-utility-suite-web-search-285a3780","name":"Agent Utility Suite – Web Search","description":"Web search for agents: ranked results (title, URL, snippet, date), a direct answer when available and related searches, with country, language and recency filters. Not charged when there are no results. $0.006 USDC per call.","url":"https://x402-agent-api.onrender.com/api/v1/web-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"num":{"type":"integer","default":8,"maximum":10,"minimum":1,"description":"How many results (1-10, default 8)."},"via":{"type":"string","maxLength":64,"description":"Optional: the tool whose next_calls suggested this call (filled in for you)."},"query":{"type":"string","maxLength":400,"minLength":1,"description":"What to search for, e.g. \"best open-source vector database 2026\" or \"site:sec.gov Apple 10-K\"."},"country":{"type":"string","pattern":"^[a-z]{2}$","description":"Two-letter country for local results, e.g. us, gb, de. Default: us."},"language":{"type":"string","pattern":"^[a-z]{2}$","description":"Two-letter language code, e.g. en, de, fr."},"time_range":{"enum":["day","week","month","year"],"type":"string","description":"Only results from the past day, week, month or year (news, recent events)."}}},"responseSchema":{"type":"json","example":{"count":1,"query":"x402 payment protocol","answer":null,"results":[{"url":"https://www.x402.org/","date":null,"title":"x402 - Payments for the internet","snippet":"An open protocol for internet-native payments...","position":1}],"provider":"serper","next_calls":[],"related_searches":["x402 coinbase"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z2Oozu4xptcJALvFuz2Ok","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a web search and returns ranked results with titles, snippets, and URLs, optionally filtered by country, language, and time range.","exampleAgentPrompt":"Search the web for 'best open-source vector databases 2025' and give me the top 8 results from the past year.","exampleUseCases":[{"title":"Recent competitor news monitoring","prompt":"Search the web for news about OpenAI product launches from the past month and give me the top 5 results."},{"title":"SEC filing discovery via web search","prompt":"Search 'site:sec.gov Tesla 10-K 2024' and return the top 3 results so I can find the latest Tesla annual filing."},{"title":"Current events research","prompt":"Find the top 10 web results about the US Federal Reserve interest rate decision this week — filter to the past 7 days and US sources."}],"resultDescription":"A JSON object containing the count of results, the original query, an optional direct answer, a list of ranked results each with URL, title, snippet, date, and position, a provider field (serper), related search suggestions, and next_calls hints for chaining with other endpoints.","failureModes":["Empty results if query is too niche or misspelled","Truncated snippets for paywalled or thin-content pages","No date returned for pages without structured date metadata","Rate limiting or 402 payment failure if USDC balance is insufficient","Time range filter may return fewer results than requested if little recent content exists","Country/language filter may be ignored by provider for certain queries"],"whenToPreferThis":"Choose this endpoint when you need live, ranked web search results with snippets and URLs — especially when you want to filter by recency (day/week/month/year), locale, or language. Prefer it over static knowledge or SEC-specific endpoints when the query spans general web content, news, or third-party commentary. It is particularly useful for chaining: use it to discover URLs and then pass those to the web-to-Markdown endpoint for full content extraction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:42:27.894Z","isFirstParty":false,"canonicalSlug":"agent-utility-suite-web-search-285a3780"}