Skip to main content
GET
Research search demand for a keyword.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Query Parameters

companyId
string
required

Company ID

keyword
string
required

Seed keyword to research. The lookup expands this into related terms automatically.

country
string

Two-letter country code. Defaults to "us".

language
string

Two-letter language code. Defaults to "en".

includeSerp
boolean

Also return the top organic results for the seed keyword

refresh
boolean

Bypass the cache and re-purchase. Costs credits - leave false unless the data is known to be stale.

sortBy
enum<string>

Sort field. One of: volume, cpc, competition, keyword. Defaults to volume.

Available options:
volume,
cpc,
competition,
keyword

Response

Keyword demand metrics

Demand metrics for the seed keyword and its related terms

seed
string

The keyword that was researched

country
string

Country the metrics apply to

language
string

Language the metrics apply to

keywords
object[]

The seed keyword plus related terms, with metrics

serp
object[]

Top organic results, when includeSerp was set

purchased
boolean

Whether this lookup bought new data. False means it was served from cache and cost nothing.

fromCache
integer

How many keywords were already cached

requested
integer

How many keywords were purchased

creditCost
integer

Credits charged. Zero on a cache hit.