Douyin

Douyin Live Room API

Get a Douyin live room by its web_rid or live.douyin.com URL: live status, stream title, viewer and like counts, cover, playback stream URLs and the host's profile. Costs 1 credit per request.

POST/api/v1/douyin/live/room

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

web_ridstring

The live room's web_rid - the number in live.douyin.com/<web_rid>. Send this or live_room_url.

Example: 80017709309

live_room_urlstring

The full live room URL. Must be an absolute URL. Send this or web_rid.

Example: https://live.douyin.com/80017709309

danmaku_typestring

Deprecated and ignored. Live chat is not returned by this endpoint.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
result = client.douyin.request("/api/v1/douyin/live/room", {"web_rid": "80017709309"})
room = result["data"]["room"]["data"][0]
print(room["status"] == 2, room["title"], room["user_count_str"])

Response

"response_time": 1666

}