Skip to main content
GET
Get a story and its articles

Authorizations

x-api-key
string
header
required

Your NewsCatcher API key, created in the NewsCatcher platform. Send it in the x-api-key header of every request.

Path Parameters

story_id
string
required

Id of the story: the story.id of a search result (a UUID).

Example:

"6f1c2b0e-2f0f-4d52-9a0b-5d0e8a5f9d11"

Query Parameters

limit
integer
default:50

Number of articles to return (1 to 500).

Required range: 1 <= x <= 500
Example:

50

Response

The story and its articles.

A story and its articles.

story_id
string
required

Id of the story.

Example:

"6f1c2b0e-2f0f-4d52-9a0b-5d0e8a5f9d11"

articles_total
integer
required

Number of distinct articles of the story.

Required range: x >= 0
Example:

43

newsrooms
integer
required

Number of newsrooms (distinct publishers) that cover the story.

Required range: x >= 0
Example:

40

articles
NewsStoryArticle · object[]
required

The articles of the story, best sources first.

first_seen
string<date-time> | null

Publication time of the earliest article (UTC, ISO 8601).

Example:

"2026-10-28T00:41:10+00:00"

last_seen
string<date-time> | null

Publication time of the latest article (UTC, ISO 8601).

Example:

"2026-10-28T13:58:02+00:00"