Rank Tracking

Keyword performance changes

Changed on

Returns rising, falling, new, and lost keywords by comparing average position across two time periods.

get/v3/rank-tracking/keyword-changes

Request

  • Base URL: https://api.snowseo.com
  • URL: https://api.snowseo.com/v3/rank-tracking/keyword-changes
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

pageinteger
searchstring
sortBy'kw' | 'pos' | 'imp' | 'clicks' | 'pages' | 'posDelta'
sortDir'asc' | 'desc'
category'rising' | 'falling' | 'new' | 'lost'
teamIdstring

Team ID

startDatestring

Start date (YYYY-MM-DD, UTC). Omit with endDate set for All Time: the lists come back empty, as All Time has no previous period.

endDatestring

End date (YYYY-MM-DD, UTC)

limitinteger

Max results per category

pageSizestring

Rows per category, or all.

includePagesstring

Include ranked page details. Default true.

devicestring

Device filter

typestring

Search type filter

countrystring

Country filter

scope'all' | 'ranked' | 'tracked'

Keyword universe: all (GSC + tracked), ranked (GSC only), tracked (tracked only). Defaults to all.

Response

Default Response

pageinteger
pageSizeinteger
totalinteger
totalPagesinteger

Changes

  • 7ede4ba45814Revision changes
    • info

      added the new optional query request parameter category

    • info

      added the new optional query request parameter includePages

    • info

      added the new optional query request parameter page

    • info

      added the new optional query request parameter pageSize

    • info

      added the new optional query request parameter search

    • info

      added the new optional query request parameter sortBy

    • info

      added the new optional query request parameter sortDir

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 60ff6690f93cRevision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      added the new falling enum value to the // response property for the response status

    • warning

      added the new falling enum value to the // response property for the response status

    • warning

      added the new rising enum value to the // response property for the response status

    • warning

      added the new rising enum value to the // response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      removed the losers enum value from the // response property for the response status

    • info

      removed the losers enum value from the // response property for the response status

    • info

      removed the winners enum value from the // response property for the response status

    • info

      removed the winners enum value from the // response property for the response status