核心问题：Search API的局限性 #

你使用的search.list接口并非检测频道直播状态的可靠方式，它的eventType=live仅返回已被YouTube搜索系统索引到的公开直播，存在以下盲区：

• 刚开播的直播可能还未被搜索索引，导致接口返回空结果
• 部分频道的直播设置了「不允许被搜索」，但仍可在频道页正常观看
• YouTube搜索索引存在延迟，无法实时同步直播状态

更可靠的检测方式 #

推荐使用以下两个API端点，直接获取频道的直播状态，覆盖所有公开直播场景：

方式1：Channels API（最简方案） #

调用channels.list接口，请求part=status，通过返回的liveBroadcastContent字段判断：

• 值为"live"：频道正在直播
• 值为"upcoming"：有即将开始的直播
• 值为"none"：无直播

示例curl请求：

curl -X GET "https://www.googleapis.com/youtube/v3/channels?part=status&channelId=UCLdl1fJeDXzdid6AmXE2YHg&key={API_KEY}"

方式2：LiveBroadcasts API（获取直播详情） #

调用liveBroadcasts.list接口，指定broadcastStatus=active，直接获取频道正在进行的直播信息：

示例curl请求：

curl -X GET "https://www.googleapis.com/youtube/v3/liveBroadcasts?part=snippet&channelId=UCLdl1fJeDXzdid6AmXE2YHg&broadcastStatus=active&key={API_KEY}"

返回的items数组不为空时，说明存在正在进行的直播。

额外排查点 #

• 检查你的API_KEY是否开启了YouTube Data API v3的访问权限，且配额未耗尽
• 若直播存在地区限制，可去掉请求中的regionCode参数，或设置为你所在地区的代码，避免API返回地区过滤后的结果

内容的提问来源于stack exchange，提问作者c0sx86