Skip to main content
GET
/
v3
/
rank-tracking
/
keyword-history
Keyword position history
curl --request GET \
  --url https://api.snowseo.com/v3/rank-tracking/keyword-history \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "date": "<string>",
      "position": 123,
      "clicks": 123,
      "impressions": 123
    }
  ]
}
See how a keyword’s search position has changed over time. Useful for tracking the impact of SEO changes or content updates.

​
Key fields

FieldWhat It Tells You
itemsArray of daily data points with position, clicks, and impressions
sourceWhere the data is from — gsc (Google Search Console) or internal (SnowSEO’s own tracking)
Position data comes from Google Search Console when available. If there isn’t enough GSC data, SnowSEO falls back to its own internal tracking.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
teamId
string

Team ID

​
keyword
string

Keyword to get history for

​
startDate
string

Start date (YYYY-MM-DD, UTC). Preferred over days.

​
endDate
string

End date (YYYY-MM-DD, UTC). Preferred over days.

​
days
integer

Number of days to look back (legacy fallback)

​
country
string

Country filter

Response

Default Response

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