# How do I get Douyin live room data: viewers, products and top streamers?

> A Douyin live room's current viewers, total visitors, likes and shopping-bag product count by room or account, plus Xingtu's live-selling boards by category. What comes back, offline rooms, cost.

Canonical page: https://okdata.online/answers/douyin-live-room-data/

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

1. **A room.** [Douyin live room](/apis/douyin/live/rooms/get/) 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 returns `status` (`live` or `offline`), title, host, start time, and under `metrics`: `viewers` (watching now), `total_viewers` (since the stream started), `likes` and `products` (items in the shopping bag).
2. **By account.** With only the streamer's profile link or sec_uid (the account ID starting `MS4wLjAB`), use [Douyin account live status](/apis/douyin/live/users/get/). 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.
3. **Boards.** [Douyin live streamer boards](/apis/douyin/live/streamers/trending/) are the boards Xingtu (巨量星图, Douyin's creator marketplace) publishes. `board` defaults to `sales` (live selling); `category` picks one of 10 product categories such as apparel, beauty or snacks; `period` is `day`, `week` or `month`. Each answer holds 100 streamers with rank, name, followers, category, a sales band in `gmv`, the number of products sold and the Xingtu creator ID.
4. **A streamer's recent record, if needed.** [Douyin streamer live figures](/apis/douyin/live/streamers/metrics/) 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:

```json
{
  "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:

```json
{ "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.** `products` is 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.** `gmv` on 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?](/answers/douyin-shop-products-reviews/)
- Creator prices on Xingtu: [How do I check Douyin Xingtu creator rates in bulk?](/answers/xingtu-creator-rates-bulk/)
- Daily competitor tracking: [How do I track a competitor's Douyin account every day?](/answers/douyin-competitor-account-tracking/)
- Finding creators: [creator discovery](/solutions/creator-discovery/)

## Endpoints used

- [Douyin live room](https://okdata.online/apis/douyin/live/rooms/get/) `douyin.live.rooms.get`: $0.002 per call
- [Douyin account live status](https://okdata.online/apis/douyin/live/users/get/) `douyin.live.users.get`: $0.004 per call
- [Douyin live streamer boards](https://okdata.online/apis/douyin/live/streamers/trending/) `douyin.live.streamers.trending`: $0.006 per call · about 100 results per page
- [Douyin streamer live figures](https://okdata.online/apis/douyin/live/streamers/metrics/) `douyin.live.streamers.metrics`: $0.04 per call

## More about Douyin

- [Douyin API](https://okdata.online/apis/douyin/)
- [Douyin API in Python: videos, profiles and comments (2026)](https://okdata.online/guides/douyin-api-python/)
- [How to export Douyin video comments in bulk](https://okdata.online/guides/douyin-video-comments/)
- [How to find Douyin Xingtu creators and get their rate cards](https://okdata.online/guides/douyin-xingtu-creator-rates/)
- [How do I shortlist creators by follower range and price on Douyin and Xiaohongshu?](https://okdata.online/answers/creator-shortlist-followers-price/)
- [How do I get Douyin Index (巨量算数) keyword trends through an API?](https://okdata.online/answers/douyin-index-keyword-trend-api/)
- [How much do Douyin and Xiaohongshu influencers charge? List prices in 11 categories (November 2026)](https://okdata.online/answers/douyin-xiaohongshu-influencer-rates-2026/)
- [How fresh is the data from a social media API?](https://okdata.online/answers/how-fresh-is-social-media-api-data/)
- [What do the prices on a Douyin Xingtu rate card mean?](https://okdata.online/answers/xingtu-rate-card-prices/)
- [How to collect Douyin comments: API, crawler or no-code (2026)](https://okdata.online/compare/douyin-comment-scraping/)
- [Douyin data APIs: official vs third-party vs open-source (2026)](https://okdata.online/compare/douyin-data-apis/)
- [Official platform APIs vs third-party data APIs (2026)](https://okdata.online/compare/official-apis-vs-data-apis/)
- [Scraping it yourself vs a per-call data API: cost, upkeep and risk](https://okdata.online/compare/scraping-vs-data-api/)
- [How to choose a social media data API (2026)](https://okdata.online/compare/social-media-data-apis/)

## Sources

Where people asked this (read 2026-11-20): 

- https://ask.csdn.net/questions/8113525
- https://www.zhihu.com/question/525769591

Updated 2026-11-20
