Answers
How do I get Douyin live room data: viewers, products and top streamers?
Short answer
With a room number, okdata's Douyin live room returns whether it is live, people watching now, people since it started, likes and the number of products in the shopping bag, for $0.002. With only the account, Douyin account live status costs $0.004. For top live sellers, Douyin live streamer boards return 100 streamers per board for $0.006. The list of products in a room is not available from these calls.
Live selling is a large share of e-commerce in China, and much of it happens on Douyin, China's TikTok. Live room data comes in two kinds, with separate endpoints. One is the state of a room right now: live or not, how many people are watching, how many have come in, likes, how many products hang in its shopping bag (小黄车, the "little yellow cart"). That suits watching a competitor's streams. The other is the boards: who sold best in a category yesterday, last week or last month, which suits finding streamers and reading a market. Room data is a snapshot of the moment you ask; for a viewer curve over a stream you poll on a schedule.
The calls
- A room. Douyin live room takes the room number or a
live.douyin.com/…link; the number is the digits in that link and stays the same from one stream to the next. It returnsstatus(liveoroffline), title, host, start time, and undermetrics:viewers(watching now),total_viewers(since the stream started),likesandproducts(items in the shopping bag). - By account. With only the streamer's profile link or sec_uid (the account ID starting
MS4wLjAB), use Douyin account live status. When live it returns the room number, title, start time and the two viewer counts; for likes and products, look the room number up with the room call. - Boards. Douyin live streamer boards are the boards Xingtu (巨量星图, Douyin's creator marketplace) publishes.
boarddefaults tosales(live selling);categorypicks one of 10 product categories such as apparel, beauty or snacks;periodisday,weekormonth. Each answer holds 100 streamers with rank, name, followers, category, a sales band ingmv, the number of products sold and the Xingtu creator ID. - A streamer's recent record, if needed. Douyin streamer live figures takes the Xingtu creator ID and returns sessions, average viewers, concurrent viewers and sales bands over 30 or 90 days, $0.04 a call.
A real run
Early on November 20, 2026 (Beijing time) we pulled the daily live-selling board for snacks. It listed 100 streamers, and the top six all sat in the same sales band, 200,000 to 2,000,000 yuan. Number two:
{
"rank": 2,
"name": "爱画画的子衿",
"followers": 16526588,
"category": "休闲食品",
"gmv": { "min": 200000, "max": 2000000 },
"products": 6,
"id": "6819657623923589127"
}
room_id was empty for all 100, marked platform in meta.unavailable, so a board does not lead straight to a room. At the same time we looked up the room of 东方甄选 (East Buy, one of Douyin's best-known live sellers), number 80017709309. At 2:30 a.m. it was not live:
{ "id": "80017709309", "status": "offline", "title": "美好生活,尽在东方甄选~", "host": { "name": "东方甄选" },
"metrics": { "viewers": null, "total_viewers": null, "likes": null, "products": null } }
An offline room returns its title and host, with every count null. The numbers come only while a stream is on.
What it costs
| Approach | Calls | Cost |
|---|---|---|
| One room, once | 1 | $0.002 |
| 20 rooms every 10 minutes through a 4-hour stream | 480 | $0.96 |
| Daily boards for 10 categories | 10 | $0.06 |
| One board, then 30-day figures for the top 10 | 11 | $0.406 |
The room call already tells you whether a stream is on. Check every half hour and only poll often once the room is live; that costs far less than polling all day.
Gotchas
- No product list.
productsis the number of items in the shopping bag; which products, their prices and sales are not returned. - Snapshots, no history. A stream's viewer curve or peak has to be built by polling and storing it yourself.
- Sales are bands.
gmvon the boards and streamer figures is a range from Xingtu, not an exact amount. - Boards lag a little. Boards come from a shared snapshot up to 5 minutes old, and the daily board is the previous day's by default.
- Board IDs are Xingtu IDs. The Xingtu creator ID is not the Douyin account ID; to watch a listed streamer's room you need their profile or room link from elsewhere.
- Nothing about viewers. Viewer lists, gifts, live comments and fan clubs are not returned.
Related
- The products and reviews behind live selling: How do I get Douyin Shop product and review data?
- Creator prices on Xingtu: How do I check Douyin Xingtu creator rates in bulk?
- Daily competitor tracking: How do I track a competitor's Douyin account every day?
- Finding creators: creator discovery
Sources
Where people asked this (read 2026-11-20)
Updated