Skip to main content
GET
/
rank-tracking
/
keyword-history
Keyword History
curl --request GET \
  --url https://v3-api-beta.snowseo.com/snowseo/v2/rank-tracking/keyword-history \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

See how a keyword’s search position has changed over time. Useful for tracking the impact of SEO changes or content updates.

Request

teamId
string
required
Your team ID.
keyword
string
required
The exact keyword text you’re tracking (e.g., domain rating checker).
days
number
default:"90"
How many days of history to return (7–365). Defaults to 90.
country
string
Country code to filter by (e.g., US, GB).

Response

{
  "items": [
    {
        "date": "2026-03-12",
        "position": 14.7,
        "clicks": 0,
        "impressions": 0,
        "source": "internal"
    }
],
"source": "internal"
}

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.