Expand keywords from autocomplete (v1) | Autocomplete API

Looks up query plus one variation per modifier word (27 lookups for alphabet) and returns every suggestion, deduplicated in keywords and per lookup in groups. Takes about 2 seconds. An unknown query returns an empty keywords 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"

modifier?string

alphabet looks up the query followed by each letter a to z, questions puts how, what, why and 10 more in front, prepositions adds for, with, vs and 7 more after.

Default"alphabet"

Value in

"alphabet"
"questions"
"prepositions"

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

{  "data": {    "query": "string",    "source": "google",    "language": "string",    "country": "string",    "modifier": "alphabet",    "count": 0,    "keywords": [      "string"    ],    "groups": [      {        "seed": "string",        "suggestions": [          "string"        ]      }    ],    "failed_seeds": [      "string"    ]  },  "details": {    "reason": "string",    "message": "string"  }}