Autocomplete Suggestions

ENDPOINTS

GET/autocomplete

Google's live autocomplete suggestions for a partial query, with entity details on the google client.

QUERY PARAMS

query *

The partial search term to complete.

Examples:

raspberry pi
how to

client

Which Google suggestion feed to use: google (with entity names and thumbnails), chrome (with relevance scores), firefox (plain) or youtube.

Default: google

Allowed values: google, chrome, firefox, youtube

limit

Maximum number of suggestions to return.

Default: 10

Allowed values: 1-20

country

2-letter country Google searches from (the gl edition). UK is accepted for GB.

Default: US

Allowed values: any ISO 3166-1 alpha-2 code (US, GB, IN, DE, FR, JP, ...)

language

Interface language of the results page (the hl code).

Default: en

Allowed values: any ISO 639-1 code (en, es, de, fr, ja, ...)

{
  "query": "raspberry pi",
  "client": "google",
  "country": "US",
  "language": "en",
  "verbatim_relevance": null,
  "count": 10,
  "suggestions": [
    {
      "position": 1,
      "text": "raspberry pi",
      "type": "query",
      "relevance": null,
      "subtypes": [
        512,
        433
      ],
      "entity": null
    },
    {
      "position": 2,
      "text": "raspberry pi 5",
      "type": "entity",
      "relevance": null,
      "subtypes": [
        512,
        433,
        613
      ],
      "entity": {
        "title": "Raspberry Pi 5",
        "subtitle": "Single-board computer",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS6O46rAyHZNv75e86Z7GYg7QME-4EBRgbs8cYe_x_vCQ&s=10"
      }
    },
    {
      "position": 3,
      "text": "raspberry pi imager",
      "type": "query",
      "relevance": null,
      "subtypes": [
        512,
        433
      ],
      "entity": null
    },
    {
      "position": 4,
      "text": "raspberry pi 4",
      "type": "query",
      "relevance": null,
      "subtypes": [
        512,
        433
      ],
      "entity": null
    },
    {
      "position": 5,
      "text": "raspberry pi zero 2 w",
      "type": "entity",
      "relevance": null,
      "subtypes": [
        512,
        433,
        613
      ],
      "entity": {
        "title": "Raspberry Pi Zero 2 W",
        "subtitle": "Single-board computer",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQqTtI8W7Jpfw2UgjOUB7Z_Po3NpcCantuXDPntxgOC&s=10"
      }
    },
    {
      "position": 6,
      "text": "raspberry pi pico",
      "type": "query",
      "relevance": null,
      "subtypes": [
        512,
        433,
        131
      ],
      "entity": null
    },
    {
      "position": 7,
      "text": "raspberry picking near me",
      "type": "query",
      "relevance": null,
      "subtypes": [
        512
      ],
      "entity": null
    },
    {
      "position": 8,
      "text": "raspberry pie",
      "type": "entity",
      "relevance": null,
      "subtypes": [
        512,
        433
      ],
      "entity": {
        "title": "Raspberry pie",
        "subtitle": null,
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQC-aEMUfh3KoB4nmimST87wCjy0IMfIs-pBbscBaTnoKqKxS07QWFzr-wgIw&s=10"
      }
    },
    {
      "position": 9,
      "text": "raspberry pi connect",
      "type": "query",
      "relevance": null,
      "subtypes": [
        512,
        433
      ],
      "entity": null
    },
    {
      "position": 10,
      "text": "raspberry pi zero",
      "type": "entity",
      "relevance": null,
      "subtypes": [
        512,
        433,
        613
      ],
      "entity": {
        "title": "Raspberry Pi Zero",
        "subtitle": "Single-board computer",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcST9kMls19t8hNs9P4xm6jlgFwnm973DJDP89gWSo5j19w13PPEkVBC_2oESQ&s=10"
      }
    }
  ]
}