先辨认拿到的是哪一种编号

如果同事提供了一个直播入口标识，你需要先确认它确实是 webcast_id，再使用这个查询。抖音的用户标识、room_id 与 webcast_id 不应因为看起来都像字符串就互相替换。任务可以很简单：在活动开始前核对目标直播间，而不是根据一个编号推断主播全部历史活动。

把结果放在当时的直播状态下理解

这个入口返回直播流数据，具体可用内容应以实际响应为准。直播可能尚未开始、已经结束或发生状态变化，一次读取不能保证几分钟后仍然可以观看。不要仅凭没有拿到期望内容，就判断活动取消或账号不存在；先回到已确认的活动来源核对时间与目标，再决定是否需要再次查看。

给值班同事留下清楚的记录

假设你负责线上活动准备，可以记录目标 webcast_id、查询时间、观察到的情况以及下一步需要核实的事项。这里的值班表是自己的工作成果，不是接口返回的活动日程。取得媒体信息不等于获准录制和传播，也不应直接把临时信息当成长期播放器配置。完成这一步后，交接内容应回答“核对的是哪一间、什么时候看过、还有什么未确定”，而不是声称直播一定持续在线。

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_user_live_videos

参数 类型 必填 含义
webcast_id string 是 直播间webcast_id

可以复制的 Python 请求

安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。

import os
import requests

# 使用自己的 TRMesh 开发者密钥；不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_user_live_videos"
params = {
    "webcast_id": "376034101029"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # 先核对真实响应，再提取业务字段

对应接口文档 · 返回免费查询工具

调用接口会使用你的 TRMesh 账号额度，运行前请确认接口价格。