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
﻿
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
https://api.scaleserp.com/search?api_key=demo&search_type=autocomplete&q=tree&location=United+States
https://api.scaleserp.com/search?api_key=demo&search_type=autocomplete&q=tree&location=United+States
﻿
﻿
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﻿

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.

Updated 22 Aug 2024

Did this page help you?

Scholar