Skip to main content
POST
Keyword Search Volume API

Keyword Search Volume

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
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
string
Minimum string length: 1
language_code
string
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