---
title: "Get a story cluster by slug"
method: GET
path: "/api/stories/{slug}"
---

# Get a story cluster by slug

`GET /api/stories/{slug}`

## Request

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

## Path parameters

- `slug` string, required

## Response `200`

Full story cluster

- object
  - `story` StoryCluster
    - `id` string
    - `slug` string
    - `headline` string
    - `excerpt` string
    - `whyItMatters` string: AI-generated 2-3 sentence context blurb (top stories only)
    - `topics` string[]
    - `rank` integer
    - `headlineTier` integer: 1=standard, 2=major, 3=top story
    - `leadUrl` string, uri
    - `leadTitle` string
    - `sourcePublisher` string
    - `sourceAuthor` string
    - `imageUrl` string, uri
    - `publishedAt` string, date-time
    - `firstSeenAt` string, date-time
    - `lastSeenAt` string, date-time
    - `xPostUrl` string, uri
    - `links` object[]
      - `id` string
      - `title` string
      - `url` string, uri
      - `publisher` string
      - `author` string
      - `linkType` 'lead' | 'sub' | 'more' | 'related'
      - `position` integer
    - `commentaryLinks` object[]
      - `id` string
      - `platform` string
      - `label` string
      - `url` string, uri
      - `position` integer
    - `techsnifArticle` object
      - `slug` string
      - `title` string
      - `publishedAt` string, date-time

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