Skip to content
UpriverUpriverUpriver API Docs

List Narratives

v1.0.0
OpenAPI 3.1.0

Upriver API

A social insights API for ad generation platforms. It provides structured signals, like psychographics, behavioral insights, trends, and audience language, to help AI models generate relevant, higher-converting ads.

Server:https://api.upriver.ai

Production API server

Client Libraries
Shell Curl

List Narratives

​

List narrative arcs, ordered by most recently updated.

Query Parameters
  • vertical
    Type: string · Verticalnullable

    Filter by vertical

  • limit
    Type: integer · Limit
    min:  
    1
    max:  
    100

    Integer numbers.

  • offset
    Type: integer · Offset
    min:  
    0

    Integer numbers.

Responses
  • application/json
  • application/json
Request Example for get/v1/topics/breakout/narratives
curl https://api.upriver.ai/v1/topics/breakout/narratives \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "narratives": [
    {
      "narrative_id": "string",
      "slug": "string",
      "display_name": "string",
      "description": "string",
      "vertical": "string",
      "member_count": 1,
      "total_citations": 1,
      "combined_source_summary": {
        "additionalProperty": 1
      },
      "date_range": {
        "additionalProperty": "string"
      },
      "created_at": "2026-09-05T06:49:26.587Z",
      "updated_at": "2026-09-05T06:49:26.587Z"
    }
  ]
}

Successful Response