API Playground

Reference

Narratives

GETList narratives

/api/v1/narratives

Description

Returns a paginated feed of all published narratives across every content type AIDRAN produces. Filter by narrative type, editorial beat, date window, or featured status to surface the stories that matter most — whether you are building a dashboard, populating a feed, or auditing editorial output over time.

Query Parameters

typestring

Narrative type: "lead_story", "beat_narrative", "dispatch", or "entity_narrative".

topicstring

Filter by topic name.

featuredboolean

Only return editorially featured narratives.

sinceISO 8601

Narratives generated after this date.

untilISO 8601

Narratives generated before this date.

limitinteger

Results per page.Default: 20, max 50

offsetinteger

Pagination offset.Default: 0

Example Response

{
  "data": [
    {
      "slug": "open-source-ai-safety-debate-intensifies",
      "type": "lead_story",
      "headline": "Open-Source AI Safety Debate Intensifies...",
      "content": "The conversation around open-source AI safety...",
      "topic": "open-source-ai",
      "topicDisplayName": "Open-Source AI",
      "category": "development",
      "signalSeverity": "high",
      "featured": true,
      "generatedAt": "2026-03-26T14:30:00.000Z",
      "version": 3,
      "entityName": null
    }
  ],
  "pagination": {
    "total": 847,
    "limit": 5,
    "offset": 0,
    "hasMore": true
  }
}

Full API Documentation

API Key

GET/api/v1/narratives--List narratives

Query Parameters

typestring

Narrative type: "lead_story", "beat_narrative", "dispatch", or "entity_narrative".

topicstring

Filter by topic name.

featuredboolean

Only return editorially featured narratives.

sinceISO 8601

Narratives generated after this date.

untilISO 8601

Narratives generated before this date.

limitinteger

Results per page.

offsetinteger

Pagination offset.

Send a request to see the response