Get a narrative by ID with member topics.
cURL
curl --request GET \ --url https://api.upriver.ai/v1/topics/breakout/narratives/{narrative_id} \ --header 'X-API-Key: <api-key>'
{ "narrative": { "narrative_id": "<string>", "display_name": "<string>", "vertical": "<string>", "member_count": 123, "created_at": "2023-11-07T05:31:56Z", "updated_at": "2023-11-07T05:31:56Z", "slug": "<string>", "description": "<string>" }, "member_topics": [ { "topic_id": "<string>", "topic_name": "<string>", "canonical_name": "<string>", "vertical": "<string>", "status": "<string>", "peak_score": 123, "discovered_at": "2023-11-07T05:31:56Z", "updated_at": "2023-11-07T05:31:56Z", "category": "<string>", "relevance_score": 123, "engagement": { "percentile_score": 123 }, "confidence_score": 123, "source_summary": {}, "citations": [ { "source_category": "<string>", "source_url": "<string>", "title": "<string>", "snippet": "<string>", "source_authority": 123, "engagement_score": 123, "published_at": "2023-11-07T05:31:56Z" } ], "entities": [ { "canonical_name": "<string>", "entity_type": "<string>", "confidence": 123, "entity_id": "<string>", "entity_subtype": "<string>" } ], "trend": { "momentum": 1, "direction": "up" }, "narrative_id": "<string>" } ] }
Successful Response
Narrative with its member topics.
A lightweight narrative arc linking related breakout topics.
Show child attributes
Topics belonging to this narrative