---
title: "Stories gaining coverage and discussion right now"
method: GET
path: "/api/stories/trending"
---

# Stories gaining coverage and discussion right now

`GET /api/stories/trending`

## Request

- Base URL: `https://techsnif.com`
- URL: `https://techsnif.com/api/stories/trending`
- Auth: none declared

Story clusters ranked by velocity inside a recent window. Velocity compares the earliest and latest pipeline snapshot in the window: commentary link delta plus coverage link delta plus rank improvement.

## Query parameters

- `hours` integer
- `limit` integer

## Response `200`

Trending stories

- TrendingResponse
  - `stories` TrendingStory[]
    - `slug` string
    - `headline` string
    - `tier` integer: Headline tier: 1=standard, 2=major, 3=top story
    - `rank` integer: Front page position, lower is more prominent
    - `leadUrl` string, uri
    - `sourcePublisher` string, nullable
    - `url` string, uri: TechSnif story page
    - `topics` string[]
    - `velocity` integer: commentaryDelta + coverageDelta + rank improvement inside the window
    - `commentaryDelta` integer
    - `coverageDelta` integer
    - `snapshotCount` integer: Pipeline snapshots recorded inside the window
  - `hours` integer: Lookback window used for this response

---

[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)