Core APIs
...
Google
Core Requests

Autocomplete

3min

Google Autocomplete Parameters

GET /search?search_type=autocomplete

The Google Autocomplete Parameters are applicable when making a request with search_type=autocomplete to retrieve autocomplete results for a given search term. The keyword searched can be specified in the q parameter and the optional location parameter can be used to geo-locate the autocomplete request (locations can be retrieved via the Locations API).

Google Autocomplete Results
Google Autocomplete Results


For example, to request autocomplete results for the keyword tree in the location United States , the request would be:

HTTP
Curl
Node.js
Python
PHP



Google Autocomplete Parameters

The following parameters are available for all requests made when search_type=autocomplete .

Parameter

Required

Description

search_type

required

Should be set to search_type=autocomplete .

q

required

The keyword you want to use to perform the Autocomplete search.

location

optional

Determines the geographic location in which the query is executed. You can enter any location as free-text, but if you choose one of the Scale SERP built-in locations then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location (note that this behaviour can be disabled via the location_auto parameter).

location_auto

optional

If the location field is set to a Scale SERP built-in location from the Locations API , and location_auto is set to true (default) then the google_domain , gl and hl parameters are automatically updated to the domain, country and language that match the built-in location. Valid values are true (default) to enable this behaviour or false to disable.

uule

optional

The Google UULE parameter - use to pass through a custom uule parameter to Google. Scale SERP automatically generates the uule when you use the location parameter but we allow you to overwrite it directly by specifying a uule directly.

google_domain

optional

The Google domain to use to run the search query. View the full list of supported google_domain values here . Defaults to google.com .

gl

optional

The gl parameter determines the Google country to use for the query. View the full list of supported gl values here . Defaults to us .

hl

optional

The hl parameter determines the Google UI language to return results. View the full list of supported hl values here . Defaults to en .

autocomplete_search_index

optional

Optional parameter to determine on which index of the string provided in the q param the autocomplete operation is requested. Different autocomplete results are returned by Google depending on the index within the search term the user currently has their cursor set to.



Next Steps      Google Autocomplete Results

Updated 22 Aug 2024
Did this page help you?