{"uid":"cap_vBN_6L0BEJyZjY6396VRU","slug":"api-direct-google-web-search-704bca0e","name":"API Direct Google Web Search","description":"Run a real-time Google search and return organic results with position, rank, title, URL, snippet, source, domain, and displayed link.","url":"https://x402.apidirect.io/v1/web/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"time":{"enum":["any","hour","day","week","month","year"],"type":"string","default":"any","description":"Time filter for results"},"pages":{"type":"integer","default":1,"maximum":10,"minimum":1,"description":"Number of result pages to fetch and merge (10 results per page). This is a count, not a page number: pages=3 returns the first 30 results in a single results array. Values above 10 are rejected with 400; values below 1 are treated as 1. Each page is billed as one request."},"query":{"type":"string","maxLength":500,"description":"Search keyword (max 500 characters, measured after leading and trailing whitespace is trimmed). Supports Google advanced operators (site:, inurl:, intitle:, etc.)"},"device":{"enum":["desktop","mobile"],"type":"string","default":"desktop","description":"Device type to simulate"},"country":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"2-letter ISO 3166-1 alpha-2 country code. A value that is not exactly 2 letters is rejected with 400."},"language":{"type":"string","default":"en","maxLength":2,"minLength":2,"description":"2-letter ISO 639-1 language code. A value that is not exactly 2 letters is rejected with 400."},"location":{"type":"string","description":"City-level geo location (e.g. London,England,United Kingdom)"},"include_ai_overview":{"type":"boolean","default":false,"description":"When true, include Google's AI Overview for the query. Only the exact value true (case-insensitive) enables it. When enabled, the response always contains an ai_overview field, which is null if Google generated no overview for the query."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__7c8kD5ccyIQoQUj6wQn_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Run a real-time Google search and return organic results with position, title, URL, snippet, source, domain, and displayed link.","exampleAgentPrompt":"Search Google for 'best open-source LLM frameworks 2024' and show me the top 10 organic results including titles, URLs, and snippets — use the US region and English language.","exampleUseCases":[{"title":"Competitor SEO ranking research","prompt":"Search Google for 'project management software for small teams' and return the first 20 organic results so I can see which competitors are ranking and what their page titles and snippets look like."},{"title":"Recent news lookup on a topic","prompt":"Do a Google search for 'quantum computing breakthroughs' filtered to results from the past week and give me the top results with their titles and URLs."},{"title":"Local business discovery by region","prompt":"Search Google for 'best Italian restaurants' as if I'm searching from a mobile device in Italy using Italian language settings and show me the top 10 results."}],"resultDescription":"An array of organic search result objects, each containing position/rank, title, URL, snippet, source name, domain, and displayed link. Optionally includes Google's AI Overview text if requested. Results are ordered by Google rank and can span multiple pages (10 results per page).","failureModes":["Missing or empty 'query' parameter returns 400 error","Country code not exactly 2 characters returns 400","Language code not exactly 2 characters returns 400","'pages' value above 10 returns 400","Query exceeding 500 characters returns 400","Payment failure due to insufficient USDC balance","No results returned for highly niche or nonsensical queries","AI overview field is null when Google generates no overview for the query"],"whenToPreferThis":"Choose this endpoint when you need real-time Google organic search results with structured metadata (position, URL, snippet, domain) per result. Prefer it over static datasets or cached indexes when freshness matters, when you need country- or language-specific SERPs, when you want to simulate mobile vs desktop search behavior, or when you need Google's AI Overview. Each page of 10 results is billed separately at $0.005 USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:01.145Z","isFirstParty":false,"canonicalSlug":"api-direct-google-web-search-704bca0e"}