---
title: "Rank and coverage history for one story"
method: GET
path: "/api/stories/{slug}/timeline"
---

# Rank and coverage history for one story

`GET /api/stories/{slug}/timeline`

## Request

- Base URL: `https://techsnif.com`
- URL: `https://techsnif.com/api/stories/{slug}/timeline`
- Auth: none declared

One point per pipeline snapshot (recorded every 30 minutes), oldest first: rank, headline tier, commentary link count, and coverage link count over time.

## Path parameters

- `slug` string, required

## Response `200`

Story timeline

- object
  - `timeline` ClusterTimeline
    - `slug` string
    - `headline` string
    - `firstSeenAt` string, date-time, nullable
    - `lastSeenAt` string, date-time, nullable
    - `points` TimelinePoint[]
      - `at` string, date-time
      - `rank` integer, nullable
      - `tier` integer, nullable
      - `commentaryCount` integer
      - `coverageCount` integer

## Other responses

- `404`: Resource not found

---

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