Skip to main content
GET
Get Topic Story View

Authorizations

X-API-Key
string
header
required

Path Parameters

topic_id
string
required

Breakout topic UUID returned by GET /v1/topics/breakout or POST /v1/topics/breakout/search. Do not pass raw query text or domains.

Query Parameters

include
enum<string>[]

Optional related data to include. Allowed: "citations", "entities".

Available options:
citations,
entities
include_citations
boolean
default:false
deprecated

Deprecated: use include=["citations","entities"] instead.

Response

Successful Response

Response for a cluster/timeline/story surface seeded by one topic.

requested_view
enum<string>
required

Requested derived view

Available options:
cluster,
story,
timeline
seed_topic
BreakoutTopicResponse · object
required

Seed topic

surface
StorySurfaceResponse · object
required

Resolved story surface

member_topics
BreakoutTopicResponse · object[]

Hydrated member topics in surface order

search_match
StorySearchMatchResponse · object | null

Search-only metadata explaining why this story matched