YouTube Channel Videos API

YouTube Channel Videos

主要特性

• 多频道视频采集一个请求可以获取多个频道的公开普通视频。
• 单频道结果上限为每个输入频道分别应用 results_limit，默认值为 100。
• 标准化视频元数据统一返回视频身份、内容资料、缩略图、时长、发布时间和发布频道。
• 时间点互动指标通过 collected_at 记录公开观看数、点赞数和评论数，便于后续对比。
• 常规视频范围排除 Shorts 和直播，让结果专注于频道普通视频。

参数

如何使用

先决定每个频道需要近期样本还是更深回溯，再采集干净的普通视频清单。一个批次可包含多个频道，但请求上限会分别应用。

1. 准备公开频道 URL，并决定只看近期样本，还是进行更深的目录回填。
2. 向 /v1/youtube/channel-videos POST urls 和 results_limit，注意上限按频道计算。
3. 轮询 /v1/tasks/{task_id}，直到频道清单任务成功或失败。
4. 按频道 ID 分组、按视频 ID 去重；has_more 为 true 时继续翻页。

curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 GET /v1/tasks/{task_id}?limit=50

最佳使用场景

• 频道视频内容流： 为选定频道建立结构化的公开普通视频内容流。
• 发布与表现分析： 比较不同频道的发布频率、视频时长、内容主题和公开互动。
• 创作者与竞品监控： 跟踪创作者、媒体、品牌或竞品的普通视频发布活动。
• 视频目录建设： 无需逐条收集视频 URL，即可为分类、摘要、搜索或报表流程补充视频数据。

使用建议

• 请求规模会按输入相乘。10 个频道配合 results_limit 100，最多请求 1,000 条普通视频记录。
• 接入新频道集合时先浅采集，检查内容是否符合预期，再只为需要历史数据的频道提高上限。
• 结果较少可能只是频道没有足够的公开普通视频，不等同于任务失败。
• 不要把响应描述成完整档案，公开可见性和频道内容列表都可能变化。
• 使用视频 ID 去重，同时保留来源频道 ID 与 collected_at，才能做长期比较。
• 需要研究内容形式时，先分别采集 Shorts 与普通视频，再在分析阶段合并。
• 频道简介和受众字段应从 Channels 获取，不要在每条上传记录中复制整套可变资料。

相关 API