Retrieve Webcast user ID

GET/webcast/anchors/{unique_id}/user_id

Resolve a TikTok

Path Parameters

unique_id*string

Responses

200Ok

Response Attributes

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

Retrieve Webcast user earnings

GET/webcast/anchors/{unique_id}/earnings

Retrieve TikTok LIVE earnings for a specific user.

Path Parameters

unique_id*string

Query Parameters

periodenum

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

200Ok

Response Attributes

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

GET/webcast/anchors/{unique_id}/gift_gallery

Retrieve the TikTok LIVE gift gallery (sponsorable gifts + sponsorship progress) for a creator.

The gallery is rendered per-viewer, so a session is required.

Path Parameters

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

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

200Ok

Response Attributes

code*number (double)
messagestring
dataobject

Gallery entrance payload. Only the fields we model are typed; the rest of the (large) TikTok response rides through as any.

||
Request
Response200

Retrieve room video

GET/webcast/anchors/{unique_id}/room_video

Fetch TikTok LIVE Stream video given a uniqueId.

Path Parameters

unique_id*string

Query Parameters

streamTypeenum
redirectboolean= true

Responses

200Ok

Response Attributes

code*number (double)
messagestring
pullMapobject

Construct a type with a set of properties K of type T

||
Request
Response200

Retrieve room info

GET/webcast/anchors/{unique_id}/room_info

Retrieve TikTok Live Room Information

Path Parameters

unique_id*string

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

200Ok

Response Attributes

code*number (double)
messagestring
ok*boolean
routes_attempted*string[]
data*object
||
Request
Response200

Retrieve Room ID

GET/webcast/anchors/{unique_id}/room_id

Fetch Room ID for a given uniqueId & whether that user is live.

Path Parameters

unique_id*string

Responses

200Ok

Response Attributes

code*number (double)
messagestring
ok*boolean
routes_attempted*string[]
is_liveboolean
room_idstring
sourcestring

Where the room id came from: "alerts_server" or the room-info route used.

||
Request
Response200

Retrieve room cover

GET/webcast/anchors/{unique_id}/room_cover

Fetch TikTok LIVE Stream Cover URL given a uniqueId.

Path Parameters

unique_id*string

Query Parameters

redirectboolean= true

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

200Ok

Response Attributes

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

Retrieve live analytics video list

GET/webcast/anchors/me/rooms

Retrieve the list of past livestreams with analytics for the authenticated user.

Note: The session you attach must own the livestream to check analytics for a given room_id.

Query Parameters

countnumber (double)= 10
offsetnumber (double)= 0

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

200Ok

Response Attributes

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

Retrieve live analytics video detail

GET/webcast/anchors/me/rooms/{room_id}/details

Retrieve detailed analytics for a specific past livestream.

Note: The session you attach must own the livestream to check analytics for a given room_id.

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.

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

200Ok

Response Attributes

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

Retrieve live analytics user interactions

GET/webcast/anchors/me/rooms/{room_id}/interactions

Find out how long a user watched your stream, the # of comments sent, likes, the comments themselves, and more analytics data.

Note: The session you attach must own the livestream to check analytics for a given room_id.

Returns details about a user's activity in a room including comments, likes, shares, and watch duration.

Path Parameters

room_id*string

Query Parameters

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

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

200Ok

Response Attributes

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