YouTube Shorts API

YouTube Shorts

主要特性

• 多频道 Shorts 采集一个请求可以获取多个频道的公开 Shorts。
• 单频道结果上限为每个输入频道分别应用 results_limit，默认值为 100。
• 标准化 Short 元数据统一返回 Short 身份、内容资料、缩略图、时长、发布时间和发布频道。
• 时间点互动指标通过 collected_at 记录公开观看数、点赞数和评论数，便于后续对比。
• 平台原生 Shorts 范围遵循 YouTube 的 Shorts 分类，不只通过固定时长或画幅定义短内容。

参数

如何使用

为明确的频道集合建立干净短内容流。先保留平台分类，再由业务在下游添加自己的时长或主题规则。

1. 准备公开频道 URL；已知单条 Short URL 需要直接查询时使用 Videos。
2. 向 /v1/youtube/shorts POST urls 和 results_limit，并按每个频道计算请求上限。
3. 轮询 /v1/tasks/{task_id}，直到频道短内容清单处理完成。
4. 按 Short ID 建立索引，保留频道和采集语境；has_more 为 true 时继续翻页。

curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
  -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

最佳使用场景

• 短内容发布监控： 跟踪选定创作者、品牌、媒体或竞品发布的公开 Shorts。
• Shorts 表现对比： 比较不同频道 Shorts 的发布频率、时长、观看数、点赞数和评论数。
• 短内容目录建设： 构建标准化公开 Shorts 集合，用于内部搜索、审核或报表。
• 主题与趋势分析： 把标题、简介、hashtag、频道信息和公开指标接入分类或研究流程。

使用建议

• 不要用统一时长阈值重新分类结果。这个端点以 YouTube 的公开内容分类为准。
• 上限按频道计算，而且只是最大值；有些频道只有少量或没有符合条件的公开 Shorts。
• 使用返回 ID 去重，同一内容可能通过其他有效 URL 写法进入你的系统。
• 为指标保留 collected_at，Short 发布后的公开计数可能在短时间内快速变化。
• 本接口不按关键词搜索。主题发现先用 Search，已知 Short URL 的直接详情使用 Videos。
• 需要比较内容形式时，分别采集 Channel Videos 和 Shorts，再在分析阶段合并。
• 频道简介和受众字段通过频道 ID 关联 Channels，不要重复写入每条 Short。

相关 API