Google Autocomplete Keyword Suggestions

Find Google Autocomplete suggestions for a search phrase in the country or region and language you choose. The assistant matches supported settings; the example uses Google’s search-results page. Suggestions can inspire more searches but do not prove search volume or popularity.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use google-autocomplete-live-advanced-dataforseo. Accept one ordinary search phrase, a country or region name, and a language name. Do not ask users to provide location/language codes or a client code. When the user does not describe another search surface, use the documented Google search-results-page client gws-wiz-serp as the standard context for this page example. If the user clearly asks for another documented context, map the plain words internally (for example, Chrome address bar to chrome-omni, Google home page to gws-wiz, Google Images to img, local results to gws-wiz-local, Google Shopping to products-cc, YouTube to youtube, or Google Search in Chrome/Safari/Firefox to the matching documented client). Do not use undocumented client values. Resolve country/region and language names to unique supported DataForSEO SERP location_code and language_code values using the official current lists; if ambiguous or unsupported, ask a plain-language follow-up rather than guessing or requesting codes. Preserve the search phrase as given; encode literal plus and percent internally as %2B and %25 where required, never ask the user to type escapes. Check current Tool availability and price, and follow the user’s existing authorization and budget. Submit one complete request with client, keyword, language_code, and location_code. Keep the submitted keyword within 256 characters. Organize the full result as candidate Google Autocomplete suggestions, preserving original order, repeats, links, and missing/null details. Do not present suggestion positions or client-dependent relevance as website rankings, search volume, popularity, difficulty, or validated recommendations. The chosen client is input context and may not be returned as a result field.

Task:
See Google Autocomplete suggestions—the searches Google shows as you type—for [Albert Einstein] in [United States] and [English]. Show the suggestions and available links.

Paste into your connected AI's conversation.

Connection guide

Up to 0.11 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Google Autocomplete Keyword Suggestions

You receive

Inspect the returned suggestion text, available search links and reported order. Your Agent can organize these candidate queries for further keyword evaluation.

Start with your task

See Google Autocomplete suggestions—the searches Google shows as you type—for [Albert Einstein] in [United States] and [English]. Show the suggestions and available links.

What to know

Suggestions depend on the selected client, location and language and may repeat the seed term. The list is not guaranteed to be unique or exhaustive, and some details may be missing. These query ideas do not include monthly search volumes, keyword difficulty or website rankings, and may differ from suggestions shown to a signed-in account.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Autocomplete request`request`	`object`	Required	Required complete object containing client, keyword, language_code and location_code. Supply all four together. The Tool returns the completed autocomplete result for this request. Required fields `language_code, location_code, keyword, client`
Search client`request.client`	`string`	Required	Required nonempty string, 1–256 characters. Use a documented client code, such as gws-wiz for the Google Search home page, gws-wiz-serp for its results page or chrome-omni for the Chrome address bar. The client can affect suggestions and available details; it is not inferred from your browser. Minimum length `1` Maximum length `256`
Seed search term`request.keyword`	`string`	Required	Required nonempty string, 1–256 characters. The autocomplete position is at the end of this seed; cursor position is not selectable. The supplier decodes percent escapes and treats plus as a space: submit %2B for a literal plus and %25 for a literal percent, keeping the submitted string within 256 characters. Minimum length `1` Maximum length `256`
Language code`request.language_code`	`string`	Required	Required nonempty string, 1–256 characters, using a supplier-supported Google SERP language code. English code en is an example, not a default. Supply the code rather than a language name. Minimum length `1` Maximum length `256`
Location code`request.location_code`	`integer`	Required	Required integer from 1 to 100000000 that is supported by the supplier’s Google SERP location list. United States code 2840 is an example, not a default. Numeric bounds alone do not establish support for a location. Minimum `1` Maximum `100000000`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "language_code",
        "location_code",
        "keyword",
        "client"
      ],
      "properties": {
        "client": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "keyword": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "language_code": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "location_code": {
          "type": "integer",
          "maximum": 100000000,
          "minimum": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Autocomplete is requested at the end of the supplied seed term; this Tool does not offer a cursor-position control. A suggestion’s search link lets you explore that query. It does not establish that the search has been executed or that demand has been evaluated.

DataForSEO Google Autocomplete reference

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

No. rank_group is the position among elements of the same type; rank_absolute is the position among all elements in this autocomplete result. They describe the returned suggestion order, not the organic ranking of a website. Keep these positions separate from any later search-results analysis.

Google Autocomplete Keyword Suggestions

Google Autocomplete Keyword Suggestions

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Enter a search phrase

Choose a country and language

Explore the suggestions

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Enter a search phrase

Choose a country and language

Explore the suggestions

Questions about this tool.

Are suggestion positions website rankings?

What does relevance measure when it is present?

Does each returned entry represent a new, unique query?

What does the result timestamp mean?

Why can thumbnails, highlighting or other details be missing?