stories

Latest stories (cursor-paginated)

Changed on

Stories newest-first by the time of their latest article (last_material_at): stories with a published summary and importance >= 7. Keyset pagination: omit cursor for the newest page, pass next_cursor back for the next (older) one; null means the end. Cursors are opaque; an invalid one is a 400. Archive depth is tiered as on the feeds — paging back past your plan's horizon (Free 30 days, Basic 90, Pro 180) returns 403 archive_horizon.

A story keeps moving up this list while articles keep joining it (last_material_at is the keyset), and its summary is rewritten as materials arrive, so re-reading a story_id later can return a different summary — updated_at says when the facts last changed.

get/api/stories/

Request

  • Base URL
    https://api.alphai.io
  • URL
    https://api.alphai.io/api/stories/
  • Auth
    HTTP bearer

Query parameters

cursorstring

Opaque cursor from a prior response's next_cursor. Omit for the newest page.

page_sizeinteger

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

Response

A page of stories.

next_cursorstring nullable required

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

Example response

{
  "results": [
    {
      "story_id": "788e477c66f3849b"
    }
  ]
}

Changes