{"uid":"cap_h9joysienOto_zk84bkz7","slug":"agentutility-web-search-ranked-google-serp-via-decodo-af3c29ed","name":"AgentUtility Web Search — Ranked Google SERP via Decodo","description":"Ranked Google results for a query: title, URL, snippet, domain, and a recency filter, via Decodo Google Search. Built for agents that need source discovery before they read or synthesize; for fetched page text or cited answers use answer-web or scrape-to-json. Use it as a web search API, SERP API, Google search API, or real-time search endpoint for agents, at a lower per-call price than the common hosted search APIs.","url":"https://x402.agentutility.ai/web-search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["query"],"properties":{"limit":{"type":"number","description":"Alias for num_results. If both are supplied, num_results wins."},"query":{"type":"string","description":"Search query or research question. 1-500 chars."},"recency":{"enum":["day","week","month","year","any"],"type":"string","description":"Optional freshness filter. Default 'any'."},"num_results":{"type":"number","description":"Number of results to return. Default 10, max 20."},"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."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"note":{"type":"string"},"query":{"type":"string"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"domain":{"type":"string"},"snippet":{"type":"string"}}}},"degraded":{"type":"boolean"},"source_url":{"type":"string"},"include_text":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"query":"x402 payment protocol examples","source":"Decodo Google Search","results":[{"url":"https://example.com/x402","title":"x402 documentation","domain":"example.com","snippet":"Pay-per-request protocol examples..."}]}},"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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9gmRbhFg39GI2HcCBg3JG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked Google search results (title, URL, snippet, domain, recency) for a query, powered by Decodo, optimized for agent source discovery workflows.","exampleAgentPrompt":"Search Google for 'best open-source LLM fine-tuning frameworks 2024' and return the top 10 ranked results with titles, URLs, snippets, and domains — filter for recent results only.","exampleUseCases":[{"title":"Pre-synthesis source discovery for research","prompt":"Before you write a summary, search Google for 'climate change adaptation strategies 2024' and give me the top 10 results with titles, URLs, and snippets so I can see what sources exist."},{"title":"Real-time news lookup for an agent pipeline","prompt":"Search Google for the latest news on 'OpenAI GPT-5 release date' and return the top 5 results filtered to recent pages only, with their titles, URLs, and snippets."},{"title":"Competitive intelligence URL gathering","prompt":"Find the top Google results for 'best project management software for remote teams' — I need the ranked list of URLs, titles, and snippets so I can decide which pages to read in depth."}],"resultDescription":"A ranked list of Google search results, each containing: result title, URL, snippet/description, domain name, and position rank. May include a recency filter option to surface only fresh results. Does not return page body text — use a scraping or fetch endpoint for that.","failureModes":["Empty results for highly niche or obscure queries","Rate limiting or quota exhaustion returning 429 errors","Payment failure via x402 protocol if USDC balance is insufficient","Query blocked or filtered by Google's content policies","Stale results if recency filter is not applied to time-sensitive queries","Network timeout on slow upstream Decodo responses"],"whenToPreferThis":"Choose this endpoint when an agent needs to discover sources, find URLs, or see ranked Google results before deciding what to fetch or synthesize. It is cheaper per call than hosted alternatives like SerpAPI or Serper.dev. Prefer it over answer-web when you want raw ranked links rather than a synthesized answer, and over scrape-to-json when you need SERP discovery rather than page content extraction. Best used as the first step in a research pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:02:57.061Z","isFirstParty":false}