google

Keyword Suggestions API for Google

Body Params
string
required

The API key to authenticate.

string
required

Seed keyword that will be used to generate suggestions. Only 1 keyword is accepted in plain text format.

exclude
array of strings

Use this parameter to specify negative keywords, i.e. the keywords that you want to exclude from your results. Must be provided in JSON format. For example, an API call that contains "keyword=iphone&exclude=["case","game","price]" will return keyword suggestions for the keyword "iphone" but there will be no keyword suggestions that contain words "case", "game", or "price". Meaning, the keyword suggestion "best iphone price" will not show up in the results.

exclude
string
Defaults to web

Specify your search vertical or category. If left blank, it defaults to "web".

string
Defaults to US

A country, you want to get keyword suggestions for. Only a single value is accepted. If left blank, it defaults to "US".

string
Defaults to en

Language, you want to get keyword suggestions for. Only a single value is accepted. If left blank, it defaults to "en".

boolean
Defaults to false

Allows to get Google Search Volume, Cost-Per-Click (CPC), and Google Ads Competition (CMP) data for keywords if this parameter is set to "true". If left blank, it defaults to "false".

metrics_location
array of int32s

Location, that you would like to localize the search volume. Accepts 1 location ID. If left blank, it defaults to global search volume.

metrics_location
metrics_language
array of strings

Language, that you would like to localize the search volume. Accepts 1 language code. If left blank, it defaults to global search volume.

metrics_language
string
Defaults to googlesearchnetwork

Search network that will be used to pull the search volume data. Accepted values are "googlesearch" or "googlesearchnetwork". If left blank, it defaults to "googlesearchnetwork".

string
Defaults to USD

The currency that will be used to display cost-per-click (CPC) data. If left blank, it defaults to USD.

string
Defaults to suggestions

Type of search query. Available types are: "suggestions", "questions", "prepositions", and "related". If left blank, it defaults to "suggestions".

boolean
Defaults to false

Allows to get the full set of autocomplete and/or search volume results. Please note that certain percent of requests might return an error if this parameter is set to "true". If left blank, it defaults to "false".

string
Defaults to json

Output of your API request. Supported parameters are "json" and "xml". If left blank, it defaults to "json".

Language
Credentials
Query
Response
Click Try It! to start a request and see the response here!