POST /v3/serp/google/autocomplete/live/advanced

Serp

Changed on Jul 26, 2026

‌‌ Google Autocomplete is a feature within Google Search that improves the search experience by allowing users to complete searches they started to type. DataForSEO SERP API will provide you with all the suggestions Google Autocomplete offers for a particular keyword, the position of the cursor pointer, and the search client.

post/v3/serp/google/autocomplete/live/advanced

Request

Base URL: https://api.dataforseo.com
URL: https://api.dataforseo.com/v3/serp/google/autocomplete/live/advanced
Auth: HTTP basic

Request body

keywordstring

keywordrequired fieldyou can specify up to 700 characters in the <code>keyword</code> fieldall %## will be decoded (plus character ‘+’ will be decoded to a space character)if you need to use the “%” character for your <code>keyword</code>, please specify it as “%25”;if you need to use the “+” character for your <code>keyword</code>, please specify it as “%2B”; learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a>

location_codeinteger

search engine location coderequired field if you don't specify <code>location_name</code>;you can receive the list of available locations of the search engines with their <code>location_code</code> by making a separate request to <code>https://api.dataforseo.com/v3/serp/google/locations</code>example:<code class="long-string">2840</code>

language_codestring

search engine language coderequired field if you don't specify <code>language_name</code>if you use this field, you don't need to specify <code>language_name</code>;you can receive the list of available languages of the search engine with their <code>language_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/google/languages</code>example:<code class="long-string">en</code>

cursor_pointerinteger nullable

search bar cursor pointeroptional fieldthe horizontal numerical position of the cursor pointer within the keyword in the search bar;by modifying the position of the cursor pointer, you will obtain different autocomplete suggestions for the same seed keyword;minimal value: <code>0</code>default value: the number of the last character of the specified <code>keyword</code>example:<code>|which query are s</code> - <code>"cursor_pointer": 0</code><code>which query is s|</code> - <code>"cursor_pointer": 16</code><code>which que|ry is s</code> - <code>"cursor_pointer": 9</code>

location_namestring

full name of search engine locationrequired field if you don't specify <code>location_code</code>if you use this field, you don't need to specify <code>location_code</code>;you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to <code>https://api.dataforseo.com/v3/serp/google/autocomplete/locations</code>example:<code class="long-string">London,England,United Kingdom</code>

language_namestring

full name of search engine languagerequired field if you don't specify <code>language_code</code>if you use this field, you don't need to specify <code>language_code</code>;you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to <code>https://api.dataforseo.com/v3/serp/google/languages</code>example:<code class="long-string">English</code>

clientstring nullable

search client for autocompleteoptional fieldautocomplete results may differ depending on the search client;possible values:<code>chrome</code> — used when google search is opened in google chrome;<code>chrome-omni</code> — used in the address bar in chrome;<code>gws-wiz</code> — used in google search home page;<code>gws-wiz-serp</code> — used in google search engine results page;<code>safari</code> — used when google search is opened in safari browser;<code>firefox</code> — used when google search is opened in firefox browser;<code>psy-ab</code> — may be used when google search is opened in google chrome browser;<code>toolbar</code> — returns XML;<code>youtube</code> — returns JSONP;<code>gws-wiz-local</code> — used in google local;<code>img</code> — used in google's image search;<code>products-cc</code> — used in google shopping search

tagstring nullable

user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified <code>tag</code> value in the <code>data</code> object of the response

Example request

[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "client": "gws-wiz-serp"
  }
]

Response

Successful operation

versionstring nullable

the current version of the API

status_codeinteger nullable

general status code you can find the full list of the response codes here

status_messagestring nullable

general informational message you can find the full list of general informational messages here

timestring nullable

total execution time, seconds

costnumber double nullable

total tasks cost, USD

tasks_countinteger nullable

the number of tasks in the tasks array

tasks_errorinteger nullable

the number of tasks in the tasks array returned with an error

Changes

Jul 26, 2026aa9f0f779507 Revision changes
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added the new optional request property /////
Jul 22, 20265ca55b1d9811 Revision changes
- breaking
  the request property ///// became not nullable
- breaking
  the request property ///// became not nullable
- breaking
  the ////////////////// response's property format changed from int64 to no format for status
- breaking
  the ////////////////// response's property format changed from int64 to no format for status
- warning
  removed the request property /////
- warning
  removed the request property /////
- warning
  removed the request property /////
- warning
  removed the request property /////

Operation history (6 revisions)