Skip to main content
GET
/
v3
/
rank-tracking
/
keyword-changes
Keyword performance changes
curl --request GET \
  --url https://api.snowseo.com/v3/rank-tracking/keyword-changes \
  --header 'Authorization: Bearer <token>'
{
  "winners": [
    {
      "keyword": "<string>",
      "clicks": 123,
      "impressions": 123,
      "position": 123,
      "clicksChange": 123,
      "impressionsChange": 123,
      "positionChange": 123,
      "previousPosition": 123,
      "previousClicks": 123,
      "previousImpressions": 123
    }
  ],
  "losers": [
    {
      "keyword": "<string>",
      "clicks": 123,
      "impressions": 123,
      "position": 123,
      "clicksChange": 123,
      "impressionsChange": 123,
      "positionChange": 123,
      "previousPosition": 123,
      "previousClicks": 123,
      "previousImpressions": 123
    }
  ],
  "new": [
    {
      "keyword": "<string>",
      "clicks": 123,
      "impressions": 123,
      "position": 123,
      "clicksChange": 123,
      "impressionsChange": 123,
      "positionChange": 123,
      "previousPosition": 123,
      "previousClicks": 123,
      "previousImpressions": 123
    }
  ],
  "lost": [
    {
      "keyword": "<string>",
      "clicks": 123,
      "impressions": 123,
      "position": 123,
      "clicksChange": 123,
      "impressionsChange": 123,
      "positionChange": 123,
      "previousPosition": 123,
      "previousClicks": 123,
      "previousImpressions": 123
    }
  ],
  "categories": [
    {
      "key": "<string>",
      "label": "<string>",
      "count": 123
    }
  ]
}
Find out which of your tracked keywords improved or dropped in position. Great for daily or weekly monitoring to catch ranking shifts early.

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.

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

currentPeriodDays
integer

Days in current period

previousPeriodDays
integer

Days in previous period

limit
integer

Max results per category

device
string

Device filter

type
string

Search type filter

country
string

Country filter

Response

Default Response

winners
object[]
losers
object[]
new
object[]
lost
object[]
categories
object[]