Skip to main content
POST
Keyword Search Volume API

Keyword Search Volume

Use language values supported by Keyword Search Volume: Chinese uses zh_CN or zh_TW, not zh. Locale support differs between SEO endpoints. Accepts up to 1,000 keywords. Each returned record corresponds to a keyword for which metrics are available. Similar keywords can occasionally share aggregated search-volume values.

Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Use language values supported by Keyword Search Volume: Chinese uses zh_CN or zh_TW, not zh. Locale support differs between SEO endpoints.

keywords
string[]
required

Keywords to analyze in one batch.

Required array length: 1 - 1000 elements
Required string length: 1 - 80
callback_url
string<uri>
language
enum<string>

Supported language name; use either language or language_code.

Available options:
Arabic,
Bengali,
Bulgarian,
Catalan,
Chinese (Simplified),
Chinese (Traditional),
Croatian,
Czech,
Danish,
Dutch,
English,
Estonian,
Farsi,
Finnish,
French,
German,
Greek,
Hebrew (old),
Hindi,
Hungarian,
Icelandic,
Indonesian,
Italian,
Japanese,
Korean,
Latvian,
Lithuanian,
Malay,
Norwegian,
Polish,
Portuguese,
Romanian,
Russian,
Serbian,
Slovak,
Slovenian,
Spanish,
Swedish,
Tagalog,
Tamil,
Telugu,
Thai,
Turkish,
Ukrainian,
Urdu,
Vietnamese
Minimum string length: 1
language_code
enum<string>

Language code supported by Keyword Search Volume. Chinese uses zh_CN or zh_TW; zh is not supported. Language sets differ between SEO endpoints.

Available options:
ar,
bg,
bn,
ca,
cs,
da,
de,
el,
en,
es,
et,
fa,
fi,
fr,
hi,
hr,
hu,
id,
is,
it,
iw,
ja,
ko,
lt,
lv,
ms,
nl,
no,
pl,
pt,
ro,
ru,
sk,
sl,
sr,
sv,
ta,
te,
th,
tl,
tr,
uk,
ur,
vi,
zh_CN,
zh_TW
Required string length: 2 - 10
location_code
integer

Search market location code.

Required range: x >= 1
location_name
string

Search market location name.

Minimum string length: 1
results_limit
integer
Required range: 1 <= x <= 2000

Response

Task accepted

code
integer
data
object