douyin/
live-room-detail

通过已知的纯数字 room_id 获取一个公开抖音直播间,返回直播标题、状态、主播身份、媒体、可见观看人数与点赞数以及采集时间。

Douyin Live Room Detail API

已知直播间查询
主播上下文
受众快照
每次请求 0.1 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Douyin Live Room Detail

抖音直播间是一场公开直播在某个时点的状态记录,可包含标题、当前状态、主播身份、媒体以及可见的观看人数与点赞数。这些字段适合补全直播间目录、跟踪场次状态,并比较不同采集时点的观测结果。

Douyin Live Room Detail API 主要特性

  • 查询已知直播间详情通过一个已知的纯数字 room_id 发起单次来源请求,最多得到一条标准化 live_room 记录,不涉及来源分页。
  • 整合直播间与主播信息把可用的直播标题、状态、主播身份、来源 URL 和采集时间保留在统一数据结构中。
  • 保存可见场次快照将可用观看人数与点赞数同公开媒体一起保存,形成带时间标记的直播间观测记录。

Douyin Live Room Detail API 参数

参数必填描述
room_id必填必填的抖音直播间标识,只能包含数字。请以字符串提交,避免较长标识被客户端舍入。

如何使用 Douyin Live Room Detail API

先准备一个已知的纯数字直播间 ID,再提交异步详情任务并读取标准化落库结果。

  1. 从能显示直播间数字标识的上下文取得 room_id;此 endpoint 不负责发现直播间 ID。
  2. 将标识作为非空纯数字字符串 POST 到 /v1/douyin/live-room-detail。
  3. 轮询 /v1/tasks/{task_id},直到状态变为 succeeded 或 failed。
  4. 通过 /v1/tasks/{task_id}?limit=50 读取 data.results.items;解析成功时最多一条记录,next_cursor 只属于 SocQ 落库结果分页。
# 发送前把 DOUYIN_ROOM_ID 设为已知的纯数字 room_id。
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"

# 轮询 GET /v1/tasks/{task_id},再通过 /v1/tasks/{task_id}?limit=50 读取 data.results.items。

Douyin Live Room Detail API 最佳使用场景

  • 补全直播间目录: 为已保存 room_id 的目录补充可用标题、状态、主播、媒体、可见指标和采集时间。
  • 跟踪场次状态快照: 分别保存多次采集结果及 collected_at,用于区分直播间状态和受众指标在各时点的观测值。
  • 核对主播与直播间上下文: 在同一条标准化记录中查看可用主播身份、直播标题、状态、媒体和场次可见计数。

Douyin Live Room Detail API 使用建议

  • 把 room_id 作为带引号的纯数字字符串提交,不要用 JavaScript number,以免长标识丢失末尾数字。
  • 调用前先取得已知 room_id,因为此请求只获取详情,不承担直播间发现功能。
  • 在自己的记录中单独保留提交的 room_id;标准化直播间结果不保证来源会把它回传到 id。
  • 将 title、status、author、metrics、media、URL 和时间字段视为可空值,因为来源可能不提供某个公开字段。
  • 不要发送 results_limit 或来源 cursor;若返回 next_cursor,它只用于翻阅 SocQ 已落库结果,而不是继续请求 provider。

除了 Douyin Live Room Detail API,需要其他类型的 Douyin 公开数据时,可以使用以下 API。

探索其他平台

还可以将 Douyin 数据与其他已支持社交平台的公开数据结合使用。

Douyin Live Room Detail API — 常见问题

Douyin Live Room Detail API 是一个通过数字 room_id 获取已知公开抖音直播间的接口,返回标准化直播间、主播、媒体、受众和采集时间字段。

请从能显示直播间数字标识的公开直播上下文取得 room_id,并将它与自己的记录一同保留。此 endpoint 不搜索直播间,也不发现 room_id。

Runtime validator 要求输入是符合纯数字格式的字符串。以文本保存也能避免较长 ID 被数字客户端舍入。

标准化记录可包含 title、status、author、URL、media、可见 viewers_count 与 likes_count、created_at 和 collected_at。任何选填来源字段都可能为 null 或缺失。

不支持。它只发起一次详情请求并最多生成一条标准化记录;任务结果中的 next_cursor 只是 SocQ 已落库数据的通用 cursor。

成功任务固定消耗 0.10 个 SocQ 积分。费用不会随结果数量或分页设置变化。