Skip to main content
GET
/
v1
/
topics
/
breakout
/
meta
List Meta-Topics
curl --request GET \
  --url https://api.upriver.ai/v1/topics/breakout/meta \
  --header 'X-API-Key: <api-key>'
{
  "meta_topics": [
    {
      "meta_topic_id": "<string>",
      "narrative_id": "<string>",
      "display_name": "<string>",
      "vertical": "<string>",
      "status": "<string>",
      "cumulative_score": 123,
      "peak_burst_score": 123,
      "member_count": 123,
      "direct_citation_count": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "scope": "<string>",
      "ranking_score": 123,
      "last_activity_at": "2023-11-07T05:31:56Z",
      "parent_meta_topic_id": "<string>",
      "is_parent": false,
      "child_count": 123
    }
  ],
  "total_count": 123,
  "next_cursor": "<string>"
}

Authorizations

X-API-Key
string
header
required

Query Parameters

vertical
string | null

Filter by vertical: 'sports', 'tech', or 'politics'

status
string
default:active

Filter by status: 'active', 'dormant', 'archived', 'all'

top_level
boolean
default:true

If true, return only top-level meta-topics (parents and ungrouped leaves). Set false to include children.

limit
integer
default:20
Required range: 1 <= x <= 100
cursor
string | null

Response

Successful Response

Response for listing meta-topics.

meta_topics
MetaTopicResponse · object[]
required

List of meta-topics ranked by composite score

total_count
integer
required

Total matching meta-topics

next_cursor
string | null

Cursor for next page