{"uid":"cap_NMoi4uVzhJwGgU8ejSaWI","slug":"openverbs-google-autocomplete-suggestions-0ffee4ff","name":"OpenVerbs Google Autocomplete Suggestions","description":"Live Google autocomplete suggestions for a partial query, localised by location and language. Returns ranked suggestion strings with a relevance score.","url":"https://search.openverbs.com/v1/suggest","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":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":700,"minLength":1,"description":"Search query."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Depth / maximum results. Defaults to 10."},"language":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Language code (2-letter). Defaults to en."},"location":{"type":"string","maxLength":120,"minLength":2,"description":"Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."}},"additionalProperties":false},"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"}}}}},"responseSchema":{"type":"json","example":{"total":10,"suggestions":[{"rank":1,"relevance":100,"suggestion":"ethereum price prediction"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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_-NmpPa5S_5IuGo00vT2EW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live, localised Google autocomplete suggestions ranked by relevance for a given partial search query.","exampleAgentPrompt":"Can you fetch Google autocomplete suggestions for the partial query 'best coffee shops in' — give me the top 10 results localised to the United Kingdom in English?","exampleUseCases":[{"title":"SEO keyword research assistant","prompt":"What does Google suggest when someone starts typing 'electric vehicles' in the US in English? Give me up to 20 autocomplete suggestions so I can find long-tail keywords to target."},{"title":"Localised search trend discovery","prompt":"Can you get me Google autocomplete suggestions for 'pizza delivery' localised to London, England, United Kingdom in English? I want to understand how people search for food delivery in the UK."},{"title":"Autocomplete-powered search UX","prompt":"Fetch Google autocomplete suggestions for the partial query 'how to fix' in Spanish, localised to Mexico, and return the top 15 suggestions — I'm building a search-assist feature for my app."}],"resultDescription":"An ordered list of autocomplete suggestion strings (up to the requested limit) each paired with a relevance score, reflecting what Google would suggest to a user who typed that partial query in the specified locale and language.","failureModes":["Empty or very short query returns no suggestions","Unsupported or misspelled language code causes an error or defaults to English","Invalid location string returns suggestions for the default location (United States)","Limit exceeding 100 is rejected with a validation error","Network timeout if Google autocomplete backend is slow","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need real-time, localised Google autocomplete data — for SEO research, populating search-suggestion UIs, or understanding user intent in a specific locale. It is preferable to scraping Google directly (which risks blocks) or using static keyword databases (which are stale). Choose it over sibling YouTube or Maps endpoints when you need general web search completions rather than video or local business suggestions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:33:17.167Z","isFirstParty":false}