API catalog / Google API / Get query suggestions

Google Autocomplete API

The suggestions Google offers for a partial query, in rank order — with entity details and spelling corrections.

GEThttps://api.endpointry.com/v1/google/autocomplete

Returns the suggestions Google offers for a partial query, in rank order, plus a spelling correction when the input looks misspelled. Each suggestion is provided as plain text and with highlight markup, and carries entity details when the suggestion maps to one. Useful for keyword research and search-as-you-type experiences.

Query parameterseditable
query *string
Response fields (data)
suggestions*array<object>
position*integer
keyword*stringThe full suggested query, as plain text.
keyword_html*stringSame suggestion with <b> around the completed portion, for UI highlighting.
entity*object | nullSet when the suggestion maps to a known entity.
title*string
label*string | null
image_url*string · uri | null
spelling_suggestion*string | nullCorrected query when the input looks misspelled, otherwise null.
Response meta

Platform fields, identical on every endpoint — what they mean.

Request
curl "https://api.endpointry.com/v1/google/autocomplete?query=best+crm" \
  -H "Authorization: Bearer sk_live_..."
Loading…
Responseexample
200 · application/json
{
  "meta": {
    "request_id": "req_7729f93d3facf68ff83e5c50",
    "as_of": "2026-07-31T12:00:00.000Z",
    "cache": "MISS"
  },
  "data": {
    "suggestions": [
      {
        "position": 1,
        "keyword": "anthropic claude",
        "keyword_html": "anthropic<b> claude</b>",
        "entity": {
          "title": "Anthropic",
          "label": "Artificial intelligence company",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCbP0WqDxmPhD2"
        }
      },
      {
        "position": 2,
        "keyword": "anthropic api pricing",
        "keyword_html": "anthropic<b> api pricing</b>",
        "entity": null
      }
    ],
    "spelling_suggestion": "anthropic"
  }
}

What teams build with it

  • Keyword research: what people actually type, ranked
  • Search-as-you-type experiences backed by real suggestion data
  • Content ideation from live query demand
  • Typo detection via built-in spelling corrections

Frequently asked questions

How many suggestions does one call return?

Up to ten, in the order Google ranks them, each with its position, plain text and highlight markup.

What are suggestion entities?

When a suggestion maps to a known entity, it carries the entity title, label and image URL — useful for rich dropdowns.

How do spelling corrections work?

When the input looks misspelled, the response includes spelling_suggestion with the corrected query as plain text.

How fresh are suggestions?

Suggestions are cached for a few minutes; meta.as_of tells you exactly when they were read.