{"uid":"cap_BBPvVA8H_ICA6MXvxn-io","slug":"tollkit-web-search-api-google-results-09bdfbdb","name":"Tollkit Web Search API (Google Results)","description":"Web search for AI agents: search the web for any query and get ranked Google results (title, URL, snippet, date) as clean JSON, plus the answer box when there is one. Fast, current results for research, fact checks and finding sources. Results via Serper.","url":"https://web.tollkit.dev/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"num":{"type":"integer","default":5,"maximum":10,"minimum":1},"query":{"type":"string","maxLength":400,"description":"What to search for."},"country":{"type":"string","pattern":"^[a-zA-Z]{2}$","description":"Two-letter country code for localised results, e.g. \"us\"."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JBfPPIYVjLJh3mRMQBmix","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the web via Google and returns ranked results (title, URL, snippet, date) plus answer boxes as clean JSON, powered by Serper","exampleAgentPrompt":"Search the web for 'best open-source LLM models 2025' and give me the top 5 results with titles, URLs, and snippets — US results please.","exampleUseCases":[{"title":"Real-time fact-checking for agent","prompt":"Search Google for 'did the Fed raise interest rates in June 2025' and show me the top 3 results with dates so I can verify this claim."},{"title":"Competitive research on a company","prompt":"Look up 'Anthropic funding rounds 2025' on the web and return the top 5 ranked results including any answer box that comes up."},{"title":"Finding sources for a blog post","prompt":"Search the web for 'impact of microplastics on human health recent studies' — I need 8 results from US sources to use as citations."}],"resultDescription":"A JSON array of ranked web results, each containing title, URL, snippet text, and publication date. If Google returns an answer box for the query, that is included as a separate top-level field. Number of results is controlled by the caller (1–10).","failureModes":["Query string exceeds 400 characters — request rejected","num parameter outside 1–10 range — validation error","Invalid country code format (not 2 letters) — rejected","Serper upstream outage — 5xx error propagated","Payment failure via x402 — 402 response, no search executed","Empty or ambiguous query may return low-quality or irrelevant results"],"whenToPreferThis":"Choose this endpoint when you need fast, current, Google-ranked web search results in clean JSON without setting up API keys or accounts — payment is handled inline via x402/USDC. Prefer it over custom scrapers or static knowledge when freshness matters (news, recent events, current prices). Ideal for AI agents that need sourced, ranked results rather than a single extracted page. Use alongside Tollkit Extract if you want to follow up by scraping a specific result page.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:30:19.748Z","isFirstParty":false,"canonicalSlug":"tollkit-web-search-api-google-results-09bdfbdb"}