{"uid":"cap_JRdHZiu26lGzVRoEyMRcg","slug":"agents-openwebninja-com-google-search-autocomplete-with-knowledge-graph-cd7be8c9","name":"Google Search Autocomplete with Knowledge Graph","description":"Get query suggestions from Google Search, including Knowledge Graph information when available.","url":"https://agents.openwebninja.com/web-search-autocomplete/autocomplete?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Autocomplete / typeahead search query."},"region":{"type":"string","default":"us","description":"The country / region from which to make the query. Allowed values: 2-letter country code, see ISO 3166-1 alpha-2."},"language":{"type":"string","default":"en","description":"Set the language of the results. Allowed values: 2-letter language code, see ISO 639-1."},"user_agent":{"enum":["desktop","mobile"],"type":"string","default":"desktop","description":"Device type to use for the search."},"cursor_pointer":{"type":"string","description":"Cursor pointer defines the position of cursor for the query provided, position starts from 0 which is a case where cursor is placed before the query.  \n  If not provided acts as cursor is placed in the end of query (Google's cp parameter)."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["query","highlights"],"properties":{"query":{"type":"string","description":"The suggested completion of the query."},"highlights":{"type":"array","items":{"type":"object","required":["offset","length"],"properties":{"length":{"type":"integer","description":"Length in characters of the matched range."},"offset":{"type":"integer","description":"Zero-based character offset where the match starts within the suggestion."}}},"description":"Character ranges within the suggestion that match the input query (for bold rendering)."},"entity_image":{"type":"string","nullable":true,"description":"Primary Knowledge Graph image URL for the entity, when available."},"entity_title":{"type":"string","nullable":true,"description":"Knowledge Graph entity title associated with the suggestion, when available."},"entity_images":{"type":"array","items":{"type":"string","description":"Image URL."},"nullable":true,"description":"Additional Knowledge Graph image URLs for the entity, when available."},"entity_subtitle":{"type":"string","nullable":true,"description":"Short Knowledge Graph subtitle / description of the entity (may be empty)."}}},"description":"List of autocomplete suggestions for the query."},"status":{"type":"string","description":"The status of the response"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"The search query string"},"region":{"type":"string","description":"The geographical region for the request"},"language":{"type":"string","description":"The language used for the query"},"user_agent":{"type":"string","description":"The user agent of the requester"},"cursor_pointer":{"type":"integer","description":"A pointer indicating the current position in paginated results"}}},"request_id":{"type":"string","description":"A unique identifier for the request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_gtPacr6X2MYpx7quN_qQT","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns Google Search query suggestions with character-level highlights and Knowledge Graph entity metadata for a given partial query string.","exampleAgentPrompt":"What search suggestions does Google show when someone starts typing 'climate cha' in the US in English? Include any Knowledge Graph entity info if available.","exampleUseCases":[{"title":"Search bar typeahead for e-commerce","prompt":"As a user types 'wireless head' into our product search bar, what Google autocomplete suggestions should I show them in English for US users on desktop?"},{"title":"Entity enrichment from partial brand name","prompt":"What does Google suggest when someone starts typing 'Tesla Mo' and are there any Knowledge Graph images or descriptions I can use to enrich those results?"},{"title":"Multilingual search suggestions for international app","prompt":"Get me Google autocomplete suggestions for the query 'fútbol' targeting the Mexico region with results in Spanish so I can power a typeahead search for our Spanish-speaking users."}],"resultDescription":"An array of autocomplete suggestion objects, each containing the full suggested query string, character-level highlight ranges (offset + length) indicating which parts match the input, and optional Knowledge Graph fields including entity title, subtitle, primary image URL, and additional image URLs. Also includes request metadata such as request_id, echoed parameters, and a status field.","failureModes":["Missing required 'query' parameter returns a validation error","Invalid region code (not ISO 3166-1 alpha-2) may return unexpected or empty results","Invalid language code may fall back to default or return an error","Query with no matching suggestions returns an empty data array","Rate limiting or quota exhaustion returns a 429 or payment-required response","Very long or malformed query strings may return an error or empty suggestions"],"whenToPreferThis":"Choose this endpoint when you need real-time Google-sourced search suggestions with character-level highlight metadata and optional Knowledge Graph entity enrichment (images, titles, descriptions). It is ideal for building search-as-you-type UI components, enriching autocomplete with entity context, or discovering popular query completions in a specific region and language. Prefer this over generic autocomplete APIs when Google's suggestion corpus and Knowledge Graph coverage matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:41.541Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-search-autocomplete-with-knowledge-graph-cd7be8c9"}