Douyin Live Room Detail
抖音直播间是一场公开直播在某个时点的状态记录，可包含标题、当前状态、主播身份、媒体以及可见的观看人数与点赞数。这些字段适合补全直播间目录、跟踪场次状态，并比较不同采集时点的观测结果。
主要特性
- 查询已知直播间详情通过一个已知的纯数字 room_id 发起单次来源请求，最多得到一条标准化 live_room 记录，不涉及来源分页。
- 整合直播间与主播信息把可用的直播标题、状态、主播身份、来源 URL 和采集时间保留在统一数据结构中。
- 保存可见场次快照将可用观看人数与点赞数同公开媒体一起保存，形成带时间标记的直播间观测记录。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
room_id | 必填 | 必填的抖音直播间标识，只能包含数字。请以字符串提交，避免较长标识被客户端舍入。 |
如何使用
先准备一个已知的纯数字直播间 ID，再提交异步详情任务并读取标准化落库结果。
- 从能显示直播间数字标识的上下文取得 room_id；此 endpoint 不负责发现直播间 ID。
- 将标识作为非空纯数字字符串 POST 到 /v1/douyin/live-room-detail。
- 轮询 /v1/tasks/{task_id}，直到状态变为 succeeded 或 failed。
- 通过 /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。最佳使用场景
- 补全直播间目录： 为已保存 room_id 的目录补充可用标题、状态、主播、媒体、可见指标和采集时间。
- 跟踪场次状态快照： 分别保存多次采集结果及 collected_at，用于区分直播间状态和受众指标在各时点的观测值。
- 核对主播与直播间上下文： 在同一条标准化记录中查看可用主播身份、直播标题、状态、媒体和场次可见计数。
使用建议
- 把 room_id 作为带引号的纯数字字符串提交，不要用 JavaScript number，以免长标识丢失末尾数字。
- 调用前先取得已知 room_id，因为此请求只获取详情，不承担直播间发现功能。
- 在自己的记录中单独保留提交的 room_id；标准化直播间结果不保证来源会把它回传到 id。
- 将 title、status、author、metrics、media、URL 和时间字段视为可空值，因为来源可能不提供某个公开字段。
- 不要发送 results_limit 或来源 cursor；若返回 next_cursor，它只用于翻阅 SocQ 已落库结果，而不是继续请求 provider。
相关 API
需要其他类型的 Douyin 公开数据时，可以使用以下 API。