Skip to main content
GET
List Breakout Entities

Authorizations

X-API-Key
string
header
required

Query Parameters

entity_type
string
required

Entity kind to rank: 'player' or 'team'

sort
string
default:recommended

Ranking mode: 'recommended' (default, balanced), 'rising' (biggest movers vs own baseline), 'top' (highest absolute volume), or 'newest' (most recently appeared). Legacy aliases (blended, hot, momentum, emerging, importance, recent, new) are accepted.

vertical
string
default:sports

Vertical; only 'sports'

tag
string | null

Filter to entities carrying this tag (e.g. a sport). Use a tag value from the /entities/breakout/tags endpoint.

temporal_status
enum<string> | null

Filter to entities with an event that has this timing relative to now: 'upcoming' (not yet started), 'ongoing' (in progress), or 'past'. Only entities tied to a scheduled event have a timing, so this narrows results to them and to their matching events. 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 implicitly restricts results to event-linked topics.

Available options:
upcoming,
ongoing,
past
event
string | null

Filter to entities involved in a specific event, by name (e.g. 'world cup'). An unrecognized event returns no entities.

limit
integer
default:20

Max entities

Required range: 1 <= x <= 100
offset
integer
default:0

Pagination offset

Required range: x >= 0
discovered_within_hours
integer | null

Only entities whose most recently appeared topic was first seen within this many hours (the 'brand new' filter). Omit for no limit.

Required range: 1 <= x <= 8760

Response

Successful Response

Ranked breaking entities for a vertical.

total_count
integer
required

Total matching entities before pagination

entities
EntityBreakoutResponse · object[]

Ranked breaking entities