SNsnowseo
Rank Tracking

Keyword timeline

Changed on

Dated events for one tracked keyword (rank moves, ranking-URL changes, cannibalisation, competitors entering or leaving the top 10, SERP reshuffles, and SERP feature changes such as an AI Overview appearing or a featured snippet changing hands) plus its tenure figures. Derived entirely from stored daily SERP snapshots, so it covers a keyword's full tracked history.

get/v3/rank-tracking/keyword-timeline

Request

Query parameters

teamIdstring

Team id

keywordstring

Keyword text; alternative to trackedKeywordId

trackedKeywordIdstring

Tracked keyword id. Preferred when a keyword is tracked in several locations, since the text alone is ambiguous.

startDatestring

YYYY-MM-DD

endDatestring

YYYY-MM-DD

daysinteger

Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. Defaults to 365.

Response

Default Response

successboolean
keywordstring
trackedKeywordIdstring
countryIdstring nullable
locationCanonicalNamestring nullable
brandDomainstring nullable
startDatestring
endDatestring

Changes

  • 31b321592ad7Revision changes
    • 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

    • 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

  • e077f2a9cb83Revision changes
    • breaking

      for the query request parameter days, default value 365 was added

    • breaking

      for the query request parameter days, the type changed from number to integer

    • warning

      for the query request parameter days, the min was set to 1.00