Fetch Webcast URL

GEThttps://api.eulerstream.com/webcast/rooms/{room_id}/connect

Fetch the WebSocket URL & first payload for a TikTok LIVE Room given a Room ID.

Path Parameters

room_id*string

The room ID to fetch the Webcast URL for. Must be a numeric string.

Query Parameters

clientstring= "ttlive-other"

The client library identifier. Used for metrics.

cursorstring

Starting cursor for the webcast connection, if any

user_agentstring

Override the user agent used for signing and fetching

client_enterboolean= true

Whether the client enters a room after connecting, or if it's done by query parameters

platformenum

Transport for a webcast fetch, and this API's own query contract. The scrape server's webcastFetch route is web-only and carries no platform, so mobile is served by the mobile signing API (see fetchWebcastMobileUrl) instead.

Header Parameters

One ofOne authentication header required
x-oauth-tokenstring

Access token from a 3rd-party Euler OAuth app.

x-cookie-headerstring

Raw TikTok cookies for direct authentication.

Responses

object
Response200

Response type is application/protobuf, so there is no JSON preview.


Send room chat

POSThttps://api.eulerstream.com/webcast/rooms/{room_id}/chat

Send a chat to a TikTok LIVE room.

Either targetRoomId or targetUniqueId must be provided to identify the room.

Path Parameters

room_id*string

Room ID

Header Parameters

One ofOne authentication header required
x-oauth-tokenstring

Access token from a 3rd-party Euler OAuth app.

x-cookie-headerstring

Raw TikTok cookies for direct authentication.

Request Body

Required

The payload configuration for sending a chat

content*string

The chat message content to send

targetRoomIdstring
targetUniqueIdstring

The username of the room to send the chat to (either this or targetRoomId is required). Pass room_id = 0 to parameter for this to work.

sessionIdstring
ttTargetIdcstring
roomIdstring

Responses

code*number (double)
messagestring
dataobject
Response200

Retrieve room gifts

GEThttps://api.eulerstream.com/webcast/rooms/{room_id}/gifts

Retrieve room-specific TikTok LIVE gift data.

Returns the ordered gift list for a specific room, along with room-specific overrides (sponsor info, gallery status, panel visibility). Use this alongside the /webcast/gift_info endpoint which provides the full gift catalog.

Path Parameters

room_id*string

The room ID of the TikTok LIVE session

Query Parameters

webcast_languageenum

Webcast language for locale-based fields

Responses

code*number (double)
messagestring
responseobject
Response200

Retrieve room info by Room ID

GEThttps://api.eulerstream.com/webcast/rooms/{room_id}/room_info

Retrieve TikTok LIVE room information by room ID.

Path Parameters

room_id*string

The TikTok LIVE room ID.

Header Parameters

x-image-sourceenum

Where a scraped image URL should be served from. Selected per-request via the x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.

Responses

code*number (double)
messagestring
ok*boolean
routes_attempted*string[]
source*object

Which source produced data. CACHE means the room came from the cache.

data*object
Response200

Retrieve room rankings

GEThttps://api.eulerstream.com/webcast/rooms/{room_id}/rankings

Retrieve the top viewers of a TikTok LIVE room: who is watching and how many coins each has given this LIVE, ranked. total is the audience count TikTok reports; ranks lists only the viewers it ranks.

Path Parameters

room_id*string

The numeric room ID of the LIVE.

Query Parameters

anchor_id*string

The numeric user ID of the room's host.

Header Parameters

One ofOne authentication header required
x-oauth-tokenstring

Access token from a 3rd-party Euler OAuth app.

x-cookie-headerstring

Raw TikTok cookies for direct authentication.

x-image-sourceenum

Where a scraped image URL should be served from. Selected per-request via the x-image-source header. Defaults to {@link RouteImageSource.ORIGIN}.

Responses

code*number (double)
messagestring
responseobject
Response200