Skip to main content
POST
https://piloterr.com
/
api
/
v2
/
google
/
search
/
autocomplete
Google Search Autocomplete
curl --request POST \
  --url https://piloterr.com/api/v2/google/search/autocomplete \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "cp": 123,
  "gl": "<string>",
  "hl": "<string>"
}
'
{
    "suggestions": [
        {
            "value": "coffee nearby"
        },
        {
            "value": "coffee"
        },
        {
            "value": "coffee near me"
        },
        {
            "value": "coffee bean"
        },
        {
            "value": "coffee shop"
        },
        {
            "value": "coffee creamer"
        },
        {
            "value": "coffee bar"
        },
        {
            "value": "coffee bean menu"
        },
        {
            "value": "coffee mate creamer"
        },
        {
            "value": "coffee liqueur"
        }
    ],
    "search_parameters": {
        "q": "coffee",
        "cp": 0,
        "gl": "us",
        "hl": "en",
        "engine": "google"
    }
}
​
x-api-key
string
required
This parameter specifies the private key you’ll need for Autom access.

​
Body

​
Search Query

​
query
string
required
The search query for which you want to get autocomplete suggestions.
​
cp
number
default:"0"
The cursor position in the search query where you want to get autocomplete suggestions.

​
Localization

​
gl
string
Parameter defines the country to use for the Google search. It’s a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries.
​
hl
string
Parameter defines the language to use for the Google search. It’s a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.

​
Response

​
Google Search Autocomplete
object
{
    "suggestions": [
        {
            "value": "coffee nearby"
        },
        {
            "value": "coffee"
        },
        {
            "value": "coffee near me"
        },
        {
            "value": "coffee bean"
        },
        {
            "value": "coffee shop"
        },
        {
            "value": "coffee creamer"
        },
        {
            "value": "coffee bar"
        },
        {
            "value": "coffee bean menu"
        },
        {
            "value": "coffee mate creamer"
        },
        {
            "value": "coffee liqueur"
        }
    ],
    "search_parameters": {
        "q": "coffee",
        "cp": 0,
        "gl": "us",
        "hl": "en",
        "engine": "google"
    }
}