YouTube Channels API

YouTube Channels

主要特性

• 多频道主页采集一个请求可以批量获取多个公开频道的资料。
• 标准化频道身份统一返回频道 ID、handle、显示名称、规范 URL、简介、头像和横幅。
• 公开频道指标包含认证状态、公开订阅者数、已发布视频数和频道总观看数。
• 主页上下文字段保留公开位置、资料链接、频道创建时间和原始输入 URL。
• 采集时间每条结果包含 collected_at，便于比较不同采集时间的频道数据。

参数

如何使用

把一批公开频道页转换成可长期使用的身份记录。请求为异步任务，请保留 task ID，直到所有可访问频道完成解析。

1. 整理并去重公开频道 URL 或 @handle URL，不要混入视频 watch URL。
2. 把 urls 数组 POST 到 /v1/youtube/channels，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}；queued 和 running 都是正常中间状态。
4. 任务成功后按 id 建立索引；若 has_more 为 true，则继续传入 next_cursor。

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

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

最佳使用场景

• 创作者和品牌目录： 为目录补充稳定频道 ID、公开资料、图片、链接和受众指标。
• 创作者筛选： 通过频道简介、认证状态、公开受众规模、发布活动和资料链接评估潜在合作对象。
• 频道数据对比： 比较创作者、品牌、媒体或竞品频道的公开订阅者数、视频数和总观看数。
• 频道资料监控： 定期采集相同频道，跟踪公开资料和受众统计数据的变化。

使用建议

• 把 id 作为主键。handle 适合展示和跳转，但它变化后仍然可能是同一个频道。
• 不要把隐藏的订阅者数写成 0。null 表示页面没有公开该值，这本身就是业务信息。
• 简介链接属于外部不可信 URL，进入内部系统或对外展示前应做校验和转义。
• 做增长比较时必须保留 collected_at，并尽量使用一致的采集频率。
• 批量任务成功并不代表每个输入都有结果；删除、限制或转为非公开的频道可能不会返回记录。
• 频道资料与内容表建议通过频道 ID 关联，不要在每条视频记录里复制整套资料字段。

相关 API