Google Search Autocomplete
Retrieve real-time Google Search autocomplete suggestions for any query, with support for language and country localization.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringThe partial or complete search query for which you want to retrieve autocomplete suggestions from Google.
Example:
coffeecp?numberCursor position in the query string where autocomplete suggestions should be generated. Determines which part of the query is being completed.
0: Suggestions based on the full query (default)5: Suggestions based on the first 5 characters of the query
"0"google_domain?stringGoogle domain to use for the search. Defaults to google.com.
Examples:
google.comgoogle.co.ukgoogle.fr
Example:
google.com"google.com"gl?stringCountry to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).
Example:
us"us"hl?stringLanguage to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).
Example:
en"en"cr?stringLimit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).
Example:
countryUSlr?stringLimit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).
Example:
lang_enfields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
suggestions?array<>search_parameters?curl -X GET 'https://api.piloterr.com/v2/google/search/autocomplete?query=string'{ "suggestions": [ { "value": "ryze mushroom coffee" }, { "value": "coffee near me" }, { "value": "mushroom coffee" }, { "value": "keurig coffee maker" }, { "value": "costa coffee" }, { "value": "zus coffee" }, { "value": "ninja coffee machine" }, { "value": "black rifle coffee" }, { "value": "delonghi coffee machine" }, { "value": "coffee shops near me" } ], "search_parameters": { "q": "coffee", "cp": 0, "gl": "us", "hl": "en", "engine": "google", "google_domain": "google.com" }}