---
title: "Stories related to an article"
method: GET
path: "/api/related"
tags: ["News"]
---

# Stories related to an article

`GET /api/related`

## Request

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

Other stories most similar to one article, from the last 7 days, nearest first. The article's own story is left out (see /api/stories). Needs an API key; a free one is enough.

## Query parameters

- `article_id` string, uuid, required
- `limit` integer

## Response `200`

OK

- RelatedResponse
  - `article_id` string, uuid, required
  - `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

## Other responses

- `400`: Missing or invalid article_id
- `401`: No API key, or an invalid one
- `404`: Unknown article
- `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 `listRelatedStories` was added
- **2026-10-01** `9db743c3b814`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/noozra/apis/noozra-news-api/changes/api/related/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)