Skip to main content
GET
/
rank-tracking
/
keyword-changes
Keyword Changes
curl --request GET \
  --url https://v3-api-beta.snowseo.com/snowseo/v2/rank-tracking/keyword-changes \
  --header 'Authorization: Bearer <token>'
Find out which of your tracked keywords improved or dropped in position. Great for daily or weekly monitoring to catch ranking shifts early.

​
Request

​
teamId
string
required
Your team ID.
​
dateRange
string
default:"7d"
The comparison time period. Accepts 7d, 30d, or 90d.

​
Response

{
  "winners": [
    {
      "keyword": "seo audit tool",
      "currentPosition": 2,
      "previousPosition": 5,
      "delta": 3
    }
  ],
  "losers": [
    {
      "keyword": "rank tracking software",
      "currentPosition": 12,
      "previousPosition": 8,
      "delta": -4
    }
  ],
  "new": [
    {
      "keyword": "ai seo platform",
      "currentPosition": 18
    }
  ],
  "lost": [],
  "categories": []
}

​
Key fields

FieldWhat It Tells You
winnersKeywords that moved closer to position #1
losersKeywords that dropped in position
newKeywords that just started ranking
lostKeywords that fell off the rankings entirely
categoriesGroupings of keyword changes by topic
A positive delta means the keyword moved closer to position #1 (good). A negative delta means it dropped.