---
title: "Keyword timeline"
method: GET
path: "/v3/rank-tracking/keyword-timeline"
tags: ["Rank Tracking"]
---

# Keyword timeline

`GET /v3/rank-tracking/keyword-timeline`

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.

## Query parameters

- `teamId` string
- `keyword` string
- `trackedKeywordId` string
- `startDate` string
- `endDate` string
- `days` number

## Response `200`

Default Response

- object
  - `success` boolean
  - `keyword` string
  - `trackedKeywordId` string
  - `countryId` string, nullable
  - `locationCanonicalName` string, nullable
  - `brandDomain` string, nullable
  - `startDate` string
  - `endDate` string
  - `events` object[]
    - `date` string
    - `type` string
    - `direction` string
    - `summary` string
    - `position` number
    - `previousPosition` number
    - `domain` string
    - `urls` string[]
    - `volatility` number
    - `feature` string
  - `volatility` object[]
    - `date` string
    - `score` number
  - `tenure` object
    - `daysTracked` number
    - `daysInTop3` number
    - `daysInTop10` number
    - `bestPosition` number, nullable
    - `bestPositionDate` string, nullable
    - `firstSeen` string, nullable
    - `currentTop10Streak` number

## Other responses

- `400` — Default Response
- `404` — Default Response
- `500` — Default Response

## Changes

- **2026-09-17** `ea8bce67cd7e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/rank-tracking/keyword-timeline/get.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/d578cdf9e232?raw)