Get the best available derived story surface around a seed topic.
curl --request GET \
--url https://api.upriver.ai/v1/topics/breakout/{topic_id}/story \
--header 'X-API-Key: <api-key>'{
"requested_view": "cluster",
"seed_topic": {
"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"
},
"citation_rate": [
{
"day": "<string>",
"count": 123
}
],
"narrative_id": "<string>",
"narrative": {
"narrative_id": "<string>",
"display_name": "<string>",
"member_count": 123,
"arc_summary": [
"<string>"
]
}
},
"surface": {
"story_id": "<string>",
"surface_type": "topic",
"member_topic_ids": [
"<string>"
],
"display_name": "<string>",
"story_score": 123,
"member_count": 123,
"lead_topic_id": "<string>",
"description": "<string>",
"latest_signal_at": "2023-11-07T05:31:56Z",
"coherence_score": 123
},
"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"
},
"citation_rate": [
{
"day": "<string>",
"count": 123
}
],
"narrative_id": "<string>",
"narrative": {
"narrative_id": "<string>",
"display_name": "<string>",
"member_count": 123,
"arc_summary": [
"<string>"
]
}
}
]
}Optional related data to include. Allowed: "citations", "entities".
Deprecated: use include=["citations","entities"] instead.
Successful Response
Response for a cluster/timeline/story surface seeded by one topic.
Requested derived view
cluster, story, timeline Seed topic
Show child attributes
Resolved story surface
Show child attributes
Hydrated member topics in surface order
Show child attributes
curl --request GET \
--url https://api.upriver.ai/v1/topics/breakout/{topic_id}/story \
--header 'X-API-Key: <api-key>'{
"requested_view": "cluster",
"seed_topic": {
"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"
},
"citation_rate": [
{
"day": "<string>",
"count": 123
}
],
"narrative_id": "<string>",
"narrative": {
"narrative_id": "<string>",
"display_name": "<string>",
"member_count": 123,
"arc_summary": [
"<string>"
]
}
},
"surface": {
"story_id": "<string>",
"surface_type": "topic",
"member_topic_ids": [
"<string>"
],
"display_name": "<string>",
"story_score": 123,
"member_count": 123,
"lead_topic_id": "<string>",
"description": "<string>",
"latest_signal_at": "2023-11-07T05:31:56Z",
"coherence_score": 123
},
"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"
},
"citation_rate": [
{
"day": "<string>",
"count": 123
}
],
"narrative_id": "<string>",
"narrative": {
"narrative_id": "<string>",
"display_name": "<string>",
"member_count": 123,
"arc_summary": [
"<string>"
]
}
}
]
}