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