---
title: "Every outlet's coverage of one story"
method: GET
path: "/api/stories/{story_id}"
tags: ["News"]
---

# Every outlet's coverage of one story

`GET /api/stories/{story_id}`

## Request

- Base URL: `https://noozra.com`
- URL: `https://noozra.com/api/stories/{story_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/noozra/apis/noozra-news-api/docs/api/stories/:story_id/get.ts> (a function with typed inputs; its response is checked against the schema)

All articles that share a `story_id`, newest first. The last 14 days for every caller; API Pro reaches the whole archive. A story merged into another since you saw its id answers under the survivor's `story_id`.

## Path parameters

- `story_id` string, uuid, required

## Query parameters

- `limit` integer

## Response `200`

OK

- StoryResponse
  - `articles` Article[], required
    - `category` string, required
    - `description` string, nullable: Publisher-supplied summary, HTML-stripped + ≤500 chars.
    - `headline` string, required
    - `id` string, required
    - `image_height` integer, nullable
    - `image_url` string, uri, nullable
    - `image_width` integer, nullable
    - `published_at` string, date-time, required
    - `source` string, required
    - `story_id` string, uuid, nullable: Shared by every outlet's coverage of the same story; see /api/stories/{story_id}.
    - `story_size` integer: Only with group=story: how many articles the story has in the listing's window.
    - `url` string, uri, required: Publisher canonical URL — link out to this, not back to Noozra.
  - `count` integer, required
  - `notice` string: No longer sent: it was on answers to requests without a key, which were answered until 2 October 2026.
  - `story_id` string, uuid, required: The story's current id; store this one.

## Other responses

- `400`: Not a UUID
- `401`: No API key, or an invalid or revoked one
- `404`: Unknown story (or, without API Pro, none of it is from the last 14 days)
- `429`: Daily rate limit exceeded (honor the Retry-After header)

## Changes

- **2026-10-29** `e0c2d7df6d6f`: 1 info
  - api tag `News` added
- **2026-10-02** `c1d37cbd3fb3`: 1 info
  - api operation id `getStory` was added
- **2026-10-01** `9db743c3b814`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/noozra/apis/noozra-news-api/changes/api/stories/:story_id/get.md)

---

[API](https://skmtc.dev/noozra/apis/noozra-news-api.md) - [All operations](https://skmtc.dev/noozra/apis/noozra-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/noozra/apis/noozra-news-api/revisions/9067da767e84?raw)