For AI

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

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

Sources

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

Updated

Connect once, then just ask.

Every new key comes with $0.10 to try it. One sentence connects your agent.

Start free
Connect your AI

Paste this into your agent

Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.

Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.

MCP serverhttps://api.okdata.online/mcp