Get autocomplete suggestions (v1) | Autocomplete API

Returns the suggestions source shows for query in the chosen language and country, usually 8 to 15, with Google's relevance score where it gives one. A query nobody types returns an empty suggestions array.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

What a person has typed so far.

Length1 <= length <= 200

source?string

Whose suggestions: Google web search, YouTube, Google Shopping, Google News, Bing, DuckDuckGo or Amazon.

Default"google"

Value in

"google"
"youtube"
"google-shopping"
"google-news"
"bing"
"duckduckgo"
"amazon"

language?string

Language as a two-letter code, such as en, de or ja.

Match^[a-z]{2,3}$

Default"en"

country?string

Country as a two-letter code. For amazon it picks the store and must be one with an Amazon store.

Match^[A-Z]{2}$

Default"US"

curl -X GET "https://example.com/v1/autocomplete/suggestions?query=best+running+shoes" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "string",    "source": "google",    "language": "string",    "country": "string",    "count": 0,    "suggestions": [      {        "text": "string",        "relevance": 0,        "type": "string"      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}