Douyin

Douyin Live Search API

Find Douyin live rooms by creator nickname or Douyin ID. Each result is a matching account with its follower count and live status; accounts that are live right now also carry the room_id and stream title. Costs 10 credits per request.

POST/api/v1/douyin/search/live

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

keywordstringrequired

Creator nickname or Douyin ID to look up. 1-200 characters. This matches accounts, not stream topics.

Example: 东方甄选

cursorinteger

Pagination cursor from the previous response. Omit or send 0 for the first page.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
result = client.douyin.request("/api/v1/douyin/search/live", {"keyword": "东方甄选"})
live = [i for i in result["data"]["items"] if i["is_live"]]
print(live)

Response

"cursor": 10,

"has_more": true

"response_time": 1585

}