TikTok LIVE Rooms

Fetch information about a TikTok LIVE room by its room ID.

Send room chat

POST/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

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

200Ok

Response Attributes

code*number (double)
messagestring
dataobject
||
Request
Response200

Fetch Webcast URL

GET/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

Query Parameters

clientstring= "ttlive-other"
unique_idstring
cursorstring
user_agentstring
client_enterboolean= true
countryenum

Region enum shared across providers that route through the pooled DC vendors. Lives in its own file (with zero imports) so consumers can load it without dragging in pooled-dc.ts's singleton init — which itself depends on OculusDc / OxyLabsDc and would otherwise close a module-init cycle the bundler resolves into a TDZ violation.

platformenum

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

200Ok

Response Attributes

object
||
Request
Response200

Response type is application/protobuf — no JSON preview available.


Retrieve room gifts

GET/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

Query Parameters

webcast_languageenum

Responses

200Ok

Response Attributes

code*number (double)
messagestring
responseobject
||
Request
Response200