Skip to main content
GET
Keyword position history
See how a keyword’s search position has changed over time. Useful for tracking the impact of SEO changes or content updates. The keyword query parameter is required (400 without it), and the default window is 90 days (see Date Windows).

Key fields

Position data comes from Google Search Console when it is connected and returns rows for the window. When Search Console is not connected, or returns no rows, SnowSEO falls back to its own internal tracking; those points have 0 clicks and 0 impressions.
The internal fallback only matches a tracked keyword whose country equals the country parameter, or one with no country when country is omitted. If there is no such keyword, items is empty.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string

Team ID

keyword
string

Keyword to get history for

startDate
string

Start date (YYYY-MM-DD on the team's calendar). days is ignored when a date is sent. History is capped at 365 days: with endDate alone, the 365 days up to endDate are returned.

endDate
string

End date (YYYY-MM-DD on the team's calendar). days is ignored when a date is sent.

days
integer
default:90

Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. Defaults to 90.

Required range: x >= 1
country
string

Country filter

Response

Default Response

items
object[]
source
enum<string>
Available options:
internal,
gsc