Skip to main content
GET
Get Keyword Rank History
Returns one row per day and market for a keyword: your site’s best rank, your target page’s rank, and the best competitor’s rank. Use it to chart a keyword over time. This endpoint only reads data.
Every request needs an API token in the Authorization header. The token decides the workspace.

Parameters

string
required
Bearer token. Format: Bearer slat_<your-token>.
number
required
Keyword ID, from List Keywords.
string
First day, in YYYY-MM-DD format. Default: 30 days before to.
string
Last day, in YYYY-MM-DD format. Default: today (UTC).
string
Only return markets in this country, for example US. Leave it out for every market.

Response

Returns 200 OK with this object:
number
required
The keyword requested.
string
required
First day returned.
string
required
Last day returned.
object[]
required
One row per day and market, oldest first. Days without a check are missing.

Errors

See Errors for the response format.

Example