How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
upriver-ai

upriver-ai Breakout Topics API

The Breakout Topics API from upriver-ai — 11 operation(s) for breakout topics.

Documentation Provider Profile APIs.io OpenAPI GitHub

upriver-ai Breakout Topics API is one of 12 APIs that upriver-ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 6 JSON Schema definitions.

Tagged areas include Breakout Topics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

This API exposes 11 operations across 11 paths, and defines 42 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.upriver.ai.

11 operations 11 paths 42 schemas 9 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.upriver.ai
Authentication
API Key
Resource Areas
1

Authentication & Security 1

upriver-ai Breakout Topics API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-Key (APIKeyHeader).

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 9 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Breakout Topics 11
GET
/v1/entities/breakout
List Breakout Entities
list_breakout_entities 9 params → 200422
GET
/v1/entities/breakout/tags
List Breakout Entity Tags
list_breakout_entity_tags 4 params → 200422
GET
/v1/entities/{entity_id}/breakout
Get Breakout Entity
get_breakout_entity 3 params → 200422
GET
/v1/topics/breakout
List Breakout Topics
list_breakout_topics 14 params → 200422
GET
/v1/topics/breakout/metadata
Get Breakout Topics Metadata
get_breakout_metadata → 200
GET
/v1/topics/breakout/narratives
List Narratives
list_narratives 3 params → 200422
GET
/v1/topics/breakout/narratives/{narrative_id}
Get Narrative
get_narrative 3 params → 200422
POST
/v1/topics/breakout/search
Search Breakout Topics
search_breakout_topics body → 200422
POST
/v1/topics/breakout/similar
Find Similar Topics
find_similar_topics body → 200422
GET
/v1/topics/breakout/{topic_id}
Get Breakout Topic
get_breakout_topic 3 params → 200422
GET
/v1/topics/breakout/{topic_id}/story
Get Topic Story View
get_breakout_topic_story_view 4 params → 200422

Schemas 42

The contract defines 42 schemas that model the data the API accepts and returns. The most detailed are BreakoutTopicResponse (24 properties), SearchTopicsRequest (12 properties), NarrativeResponse (11 properties), StorySurfaceResponse (11 properties). Each schema is shown below with its type and property counts.

EntityBreakoutResponse
object
A breaking entity (player or team) with its supporting topics.
8 properties 6 required
SimilarTopicsResponse
object
Response for similar topics.
2 properties 2 required
NarrativeDetailResponse
object
Narrative with its member topics.
2 properties 1 required
BreakoutEntityResponse
object
Resolved entity in API response.
5 properties 3 required
SimilarTopicsRequest
object
Request for finding similar topics.
5 properties 1 required
EntityBreakoutDetailResponse
object
A single entity's current breaking topics and recent activity. There is no ranking score here — that value is only meaningful in the ranked list context, not f…
8 properties 5 required
BreakoutVerticalMetadata
object
Vertical metadata with nested categories.
3 properties 3 required
SearchQueryContext
object
Optional caller context for source-aware search planning. Today this is used for Kalshi-originated queries, where the visible query text is often too terse to…
8 properties 1 required
SearchMode
string
Search mode for topic search.
StorySearchMatchResponse
object
How a story result matched the search query.
3 properties 1 required
TopicNarrativeContext
object
Inline narrative context on a topic in the list endpoint.
4 properties 3 required
ListNarrativesResponse
object
List of narratives.
1 property 1 required
ListTopicsResponse
object
Response for listing breakout topics.
8 properties 1 required
EntityBreakoutListResponse
object
Ranked breaking entities for a vertical.
2 properties 1 required
GetTopicResponse
object
Response for getting a single topic.
1 property 1 required
HTTPValidationError
object
1 property
TopicTrendResponse
object
Momentum and trend signals for a topic.
2 properties
StoryViewKind
string
Requested derived view flavor.
StoryListSource
string
How story-mode list surfaces were sourced.
SearchTopicsRequest
object
Request for searching breakout topics.
12 properties 1 required
BreakoutCitationResponse
object
Citation in API response — the full topic-surface shape. Inherits the shared display-facing fields (sourcecategory, sourceurl, title, display) from CitationBas…
8 properties 2 required
CitationRateBucket
object
A single day's citation count for charting.
2 properties 2 required
EntityTopicRef
object
A topic the entity is currently breaking in.
6 properties 2 required
ValidationError
object
3 properties 3 required
BreakoutTopicResponse
object
Single breakout topic in API response.
24 properties 8 required
StorySurfaceResponse
object
Derived story surface for a topic-seeded view.
11 properties 6 required
EntityFacetsResponse
object
Available tags to filter the breakout entity list by.
1 property
BreakoutMetadataResponse
object
Metadata about available filters for breakout topics.
1 property 1 required
EntityTimelineBucket
object
One day's activity count for an entity.
2 properties 2 required
TemporalStatusFilter
string
Filter a topic by its request-time event temporal status. Only topics linked to a scheduled event carry a temporal status, so filtering by any of these values…
EntityFacet
object
One value you can filter the breakout list by (e.g. a sport).
5 properties 5 required
StorySurfaceType
string
Surface type returned by the derived story view builder.
SearchTopicsResponse
object
Response for searching breakout topics.
4 properties 1 required
NarrativeResponse
object
A lightweight narrative arc linking related breakout topics.
11 properties 6 required
BreakoutCategoryMetadata
object
Category metadata for API discovery.
2 properties 2 required
ListSurfaceMode
string
List surface mode for breakout browse responses.
CitationSourceCategory
string
Citation source categories usable as a citation filter. A subset of the sourcecategory values that appear on returned citations — the categories worth filterin…
TopicStoryViewResponse
object
Response for a cluster/timeline/story surface seeded by one topic.
5 properties 3 required
TopicStatusFilter
string
Filter options for topic status. Note: archived is intentionally absent — archived topics are always excluded from browse/list surfaces, so it is not an accept…
TopicEngagementResponse
object
Engagement scoring signals for a topic.
1 property
TrendDirection
string
Trend direction indicator based on momentum ratio.
EntityTopicCitation
object
A supporting source for a topic — the lean entity-card citation shape. Inherits the shared citation fields (sourcecategory, sourceurl, title, display) and inte…
4 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

upriver-ai-breakout-topics-api-openapi.yml Raw ↑

Other APIs upriver-ai publishes across the network.

upriver-ai Account API
AE Profile APIs.io
upriver-ai Audience API
AE Profile APIs.io
upriver-ai Brands API
AE Profile APIs.io
upriver-ai Breakout Feeds API
AE Profile APIs.io
upriver-ai Creators API
AE Profile APIs.io
upriver-ai Images API
AE Profile APIs.io
upriver-ai Products API
AE Profile APIs.io
upriver-ai Sponsorships API
AE Profile APIs.io
upriver-ai Taxonomy API
AE Profile APIs.io
upriver-ai Trends API
AE Profile APIs.io
upriver-ai Trends Radar (Beta) API
AE Profile APIs.io
#Breakout Topics
← Back to U APIs
API Details
ID
upriver-ai:upriver-ai-breakout-topics-api
Base URL
https://api.upriver.ai
Docs
https://docs.upriver.ai/api-reference/
Provider
upriver-ai
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=upriver-ai-breakout-topics-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/upriver-ai-breakout-topics-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of upriver-ai Breakout Topics API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.