YouTube 公开数据 API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、搜索结果和可用字幕。
可用的 YouTube API
可以选择频道或视频直接查询、频道普通视频与 Shorts 采集、公开评论、关键词搜索或可用字幕文本。
可以获取哪些 YouTube 数据？
SocQ 将受支持的公开 YouTube 结果转换为标准化记录，用于数据补全、监控、研究、内容分析和报表。
频道资料
获取频道身份、简介、公开图片、认证状态，以及可见订阅者数、视频数和总观看数。
视频与 Shorts 元数据
采集标题、简介、频道信息、缩略图、时长、发布时间和可见互动。
公开讨论
采集公开可见评论文本、作者信息、点赞、回复数、视频引用和父评论关系。
发现与字幕
使用受支持筛选搜索公开普通视频，并为已知 URL 获取可用纯文本字幕。
SocQ 与 YouTube Data API 对比
SocQ 面向受支持的公开数据采集和标准化；YouTube Data API 更适合官方 OAuth、频道管理和授权操作。
| 能力 | SocQ | YouTube Data API |
|---|---|---|
| 主要用途 | 受支持的公开数据采集与标准化 | 官方平台集成与授权资源 |
| 鉴权 | SocQ API key | 根据操作使用 Google OAuth 或 API 凭据 |
| 内容管理 | 不创建、编辑、删除、点赞、评论或管理 YouTube 内容 | 支持符合条件的授权操作 |
| 私密或受限数据 | 不支持 | 仅限授权和平台政策允许的数据 |
| 响应格式 | 标准化 SocQ 记录 | YouTube API 原生资源 |
YouTube API 如何工作
七个接口共享异步提交、任务轮询和 cursor 分页生命周期。
1. 提交公开输入
通过 POST 传入受支持的频道 URL、视频 URL、搜索词和 endpoint 专属可选筛选条件。
2. 轮询任务
使用返回的 task ID 等待处理成功或失败，遇到临时压力响应时进行退避。
3. 读取并分页
从 data.results.items 读取标准化记录，并在 has_more 为 true 时继续传 next_cursor。
使用 SocQ API key 鉴权。以下请求获取公开频道资料；视频、评论、Shorts、搜索或字幕请选择对应 endpoint。
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常见 YouTube API 使用场景
创作者与频道研究
组合公开频道资料、普通视频和 Shorts，用于目录补全和对比分析。
内容与反馈监控
跟踪指定视频元数据、公开评论讨论和采集时互动快照。
主题发现
使用查询词和受支持筛选搜索公开视频，再补全已知 URL 或获取可用字幕文本。
数据管道
把标准化记录接入数据仓库、审核工具、分类器、搜索索引和报表系统。
限制与公开数据政策
YouTube 公开结果是动态的，并受当前可见性、内容分类、地区可用性以及公开字幕或评论访问状态影响。
- 私密、已删除、会员专享、地区限制、年龄限制或其他不可访问内容可能不产生记录。
- 可见计数、搜索排名、内容分类、评论和字幕会在采集后变化。
- 请求的结果上限不保证存在同等数量的合格公开记录。
- SocQ 不是 YouTube 官方 API，也不管理、创建、修改、删除、点赞或评论 YouTube 内容。
YouTube API 常见问题
SocQ 是 YouTube 官方 API 吗？
不是。SocQ 采集并标准化受支持的公开结果；官方 OAuth、频道管理和授权操作应使用 YouTube Data API。
用户需要连接 YouTube 账号吗？
这些受支持的公开数据接口不需要用户 YouTube OAuth，请求使用 SocQ API key 鉴权。
目前有哪些 YouTube 资源？
目前提供 Channels、Videos、Channel Videos、Comments、Shorts、Search 和 Transcripts，每个接口都有独立输入与标准化结果契约。
如何计费？
每个 endpoint 卡片会显示当前每条结果的积分价格，Playground 会根据 endpoint 计费规则预估请求。