给 AI

问答

抖音直播间数据怎么拿:在线人数、小黄车商品数和带货榜主播

简短回答

知道直播间号,用 okdata 的抖音直播间信息,$0.002 一次,返回此刻是否在播、当前在线人数、累计观看、点赞和小黄车商品数;只知道账号,用抖音账号开播状态,$0.004 一次。找热门带货主播用抖音直播达人榜,一次 100 位,$0.006。小黄车里具体有哪些商品,这几个接口都不提供。

直播间的数据分两类,接口也分开。一类是某个直播间此刻的状态:在不在播、多少人在线、来过多少人、点赞多少、小黄车挂了几个商品,适合盯竞品的直播。另一类是榜单:某个类目里昨天、上周或上个月卖得最好的主播是谁,适合找人和看行业。直播间的数据都是查询那一刻的快照,想要一场直播的在线人数曲线,得自己定时去查。

调用步骤

  1. 查直播间。 抖音直播间信息传直播间号或 live.douyin.com/… 链接,直播间号就是链接里那串数字,每场直播都不变。返回 status(live 或 offline)、标题、主播、开播时间,以及 metrics 里的 viewers(当前在线)、total_viewers(开播以来累计观看)、likes 和 products(小黄车商品数)。
  2. 按账号查。 只有主播的抖音主页链接或 sec_uid(MS4wLjAB 开头)时,用抖音账号开播状态。在播时返回直播间号、标题、开播时间、在线和累计观看;点赞和小黄车商品数要再拿直播间号查一次直播间信息。
  3. 看榜单。 抖音直播达人榜是星图发布的榜,board 默认 sales(带货榜),category 选类目(服装、美妆、休闲食品等 10 个),period 选 day、week 或 month。一次返回 100 位主播,带名次、昵称、粉丝数、类目、销售额区间 gmv、带货商品数和星图达人 ID。
  4. 需要的话看主播近期表现。 拿星图达人 ID 调抖音主播直播数据,返回近 30 天或 90 天的场次、场均观看、同时在线、销售额区间等,每次 $0.04。

实测示例

2026 年 11 月 20 日凌晨拉了休闲食品类的带货日榜,100 位,前 6 名的销售额区间都是 20 万到 200 万元。第 2 名:

{
  "rank": 2,
  "name": "爱画画的子衿",
  "followers": 16526588,
  "category": "休闲食品",
  "gmv": { "min": 200000, "max": 2000000 },
  "products": 6,
  "id": "6819657623923589127"
}

100 位主播的 room_id 都是空的,meta.unavailable 标为 platform,所以没法直接从榜单跳到直播间。同一时间查了东方甄选的直播间(80017709309),当时是凌晨两点半,没在播:

{ "id": "80017709309", "status": "offline", "title": "美好生活,尽在东方甄选~", "host": { "name": "东方甄选" },
  "metrics": { "viewers": null, "total_viewers": null, "likes": null, "products": null } }

下播状态下只有标题和主播信息,在线人数这些都是 null。要拿到数字,得在开播期间查。

费用

做法 调用次数 费用
查 1 个直播间 1 次 1 $0.002
盯 20 个直播间,每 10 分钟查一次,播 4 小时 480 $0.96
10 个类目的带货日榜,每天一次 10 $0.06
1 张榜,再看前 10 位的近 30 天数据 11 $0.406

直播间信息本身就能看出在不在播。盯播时先每半小时查一次,确认开播了再调高频率,比全天高频查便宜得多。

注意事项

  • 没有商品清单。 products 只是小黄车里商品的数量,具体是哪些商品、价格和销量,这几个接口不提供。
  • 只有快照,没有历史。 一场直播的在线人数曲线、峰值,要自己定时查、自己存。
  • 销售额是区间。 榜单和主播数据里的 gmv 是星图给的区间,不是精确成交额。
  • 榜单有几分钟延迟。 榜单是最多 5 分钟前的共享快照,日榜默认是前一天的。
  • 榜单 ID 是星图的。 星图达人 ID 不是抖音账号 ID,要查某位上榜主播的直播间,还得另外拿到他的主页或直播间链接。
  • 观众信息不提供。 观众名单、礼物、弹幕和粉丝团都不在返回里。

相关

资料来源

这个问题出现过的地方(读取于 2026-11-20)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp