stories

A story's articles (cursor-paginated)

Every article behind a story, oldest first — the materials the summary was written from and the ones that joined after it. Same visibility as the feed (relevance_score >= 4); each row carries its uid (open it with /api/news/{uid}/), publisher, publication time, the publisher's URL and its relevance score. A story's key_facts point into this list by source_uid. Keyset pagination with cursor / next_cursor as on /api/stories/; most stories fit one page. Only a current story (status: found) has materials: a merged or not-a-story id is a 404 here — resolve it through /api/stories/{story_id}/ first.

get/api/stories/{story_id}/materials/

Request

  • Base URL
    https://api.alphai.io
  • URL
    https://api.alphai.io/api/stories/{story_id}/materials/
  • Auth
    HTTP bearer

Path parameters

story_idstring required

Query parameters

cursorstring

Opaque cursor from a prior response's next_cursor. Omit for the first (oldest) page.

page_sizeinteger

Articles per page, 1 to 50 on every tier (default 50). limit is accepted as an alias.

Response

A page of the story's articles, oldest first.

story_idstring required
next_cursorstring nullable required

Opaque cursor for the next (newer) page; null at the end.

Example response

{
  "results": [
    {
      "publisher": "apnews.com"
    }
  ]
}

Changes