Get available dates

GEThttps://api.eulerstream.com/webcast/rankings/catalog/leaderboards/{region}/{rank_name}/dates

Retrieve the list of dates that have leaderboard data for a given rank type and region.

Requests to catalogue endpoints do NOT count towards normal API limits.

Path Parameters

rank_name*enum
region*enum

The region to query (or "WW" for worldwide).

Query Parameters

leagueenum

League level filter (e.g. "D5", "A1"). Required for RANKING_LEAGUE, must not be provided for other rank types.

Responses

code*number (double)
messagestring
dates*string[]
Response200

Get available rankings

GEThttps://api.eulerstream.com/webcast/rankings/catalog/leaderboards

Returns the available ranking types and league tiers for each tracked region, based on each leaderboard's most recent day of data in the ranking service (boards with no data for several days age out of the catalog).

Requests to catalogue endpoints do NOT count towards normal API limits.

Responses

code*number (double)
messagestring
regions*object
Response200

Get leaderboard

GEThttps://api.eulerstream.com/webcast/rankings/catalog/leaderboards/{region}/{rank_name}

Retrieve the most recent leaderboard snapshot for a given rank type, region, and date.

Requests to catalogue endpoints do NOT count towards normal API limits.

Path Parameters

rank_name*enum
region*enum

The region to query (or "WW" for worldwide).

Query Parameters

datestring (date-time)

The UTC date to retrieve the snapshot for (e.g. "2026-03-09"). Omitted = the board's most recent snapshot (matching what the catalog advertises).

leagueenum

Optional league level filter (e.g. "D5", "A1"). Only applicable to RANKING_LEAGUE.

Responses

code*number (double)
messagestring
tsstring
datestring
regionstring
rank_nameobject
leagueobject
resets_atstring | null
is_latestboolean
earningsobject

Diamond totals of the board for date, the day before, and the seven-day average; every field null unless the board scores in diamonds (DAILY_RANK).

total_liveinteger (int32)

Creators live when this snapshot was taken: for a region, its rows whose is_live.status is true; for the worldwide merge (a capped list), the day's deduplicated live count across every region's daily board, so only DAILY_RANK carries it.

ranksobject[]
Response200

Get user day history

GEThttps://api.eulerstream.com/webcast/rankings/catalog/leaderboards/{region}/{rank_name}/anchors/{numeric_id}/history/{date}

Retrieve every intraday datapoint recorded for a creator on a given board for a single UTC date, oldest first. Consecutive points carry the day's cumulative score as it grew — the deltas between them are the creator's per-interval earnings (e.g. for an earnings-per-hour view).

Requests to catalogue endpoints do NOT count towards normal API limits.

Path Parameters

rank_name*enum

The rank type identifier (e.g. "DAILY_RANK", "RANKING_LEAGUE").

region*enum

The leaderboard region (e.g. "US").

numeric_id*string

TikTok numeric user id of the creator.

date*string (date-time)

The UTC rank date to retrieve (e.g. "2026-03-01").

Responses

code*number (double)
messagestring
userobject
regionstring
rank_nameobject
datestring

The requested UTC rank date.

historyobject[]
Response200

Get user history

GEThttps://api.eulerstream.com/webcast/rankings/catalog/leaderboards/{region}/{rank_name}/anchors/{numeric_id}/history

Retrieve a creator's daily standing on a given board over a UTC date range, oldest first.

Requests to catalogue endpoints do NOT count towards normal API limits.

Path Parameters

rank_name*enum
region*enum

The leaderboard region (e.g. "US").

numeric_id*string

TikTok numeric user id of the creator.

Query Parameters

from*string (date-time)

Start of the UTC date range, inclusive (e.g. "2026-03-01").

to*string (date-time)

End of the UTC date range, inclusive (e.g. "2026-03-31").

Responses

code*number (double)
messagestring
userobject
regionstring
rank_nameobject
historyobject[]
Response200

Get user leaderboards over timespan

GEThttps://api.eulerstream.com/webcast/rankings/catalog/anchors/{numeric_id}/rank_names

Discovery: The leaderboards a creator appears on within a UTC date range, returned as a map of region to rank_types.

Rate limited to 30 requests/min. Does NOT count towards normal API limits.

Path Parameters

numeric_id*string

TikTok numeric user id of the creator.

Query Parameters

from*string (date-time)

Start of the UTC date range, inclusive (e.g. "2026-03-01").

to*string (date-time)

End of the UTC date range, inclusive (e.g. "2026-03-31").

Responses

code*number (double)
messagestring
user_numeric_idstring
fromstring
tostring
leaderboardsobject

region -> rank_names the creator appeared on (e.g. "DAILY_RANK", "SALE_RANK").

Response200

Get user streams

GEThttps://api.eulerstream.com/webcast/rankings/catalog/leaderboards/{region}/{rank_name}/anchors/{numeric_id}/streams

Retrieve the list of Room IDs in which a creator was observed in the Top 99 of the given TikTok LIVE board over a UTC date range, newest first, with their estimated earnings across each stream (daily board only; every other board reports null earnings).

Requests to catalogue endpoints do NOT count towards normal API limits.

Path Parameters

rank_name*enum
region*enum

The leaderboard region (e.g. "US").

numeric_id*string

TikTok numeric user id of the creator.

Query Parameters

from*string (date-time)

Start of the UTC date range, inclusive (e.g. "2026-03-01").

to*string (date-time)

End of the UTC date range, inclusive (e.g. "2026-03-31").

Responses

code*number (double)
messagestring
userobject
regionstring
rank_nameobject
fromstring

Start of the UTC date range, inclusive.

tostring

End of the UTC date range, inclusive.

streamsobject[]

Newest first.

Response200