YouTube 公开数据 API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
可用的 YouTube API
可以选择频道或视频直接查询、频道普通视频与 Shorts 采集、公开评论、关键词或话题标签发现，以及可用字幕文本。
youtube/channels
主页每条结果 0.26 积分
youtube/videos
帖子每条结果 0.5 积分
youtube/channel-videos
帖子每条结果 0.5 积分
youtube/playlist-videos
帖子每条结果 0.5 积分
youtube/channel-live-videos
帖子每条结果 0.5 积分
youtube/comments
评论每条结果 0.3 积分
youtube/comment-replies
评论每条结果 0.5 积分
youtube/community-posts
帖子每条结果 0.5 积分
youtube/shorts
帖子每条结果 0.5 积分
youtube/search
搜索每条结果 0.5 积分
youtube/hashtag-search
搜索每条结果 0.5 积分
youtube/transcripts
帖子每条结果 0.5 积分
可以获取哪些 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、关键词、话题标签和接口专属可选筛选条件。
2. 轮询任务
使用返回的 task ID 等待处理成功或失败，遇到临时压力响应时进行退避。
3. 读取并分页
从 data.results.items 读取标准化记录，并在 has_more 为 true 时继续传 next_cursor。
使用 SocQ API key 鉴权。以下请求获取公开频道资料；视频、评论、Shorts、关键词或话题标签发现以及字幕请选择对应接口。
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、Hashtag Search 和 Transcripts，每个接口都有独立输入与标准化结果契约。
如何计费？
每个 endpoint 卡片会显示当前每条结果的积分价格，Playground 会根据 endpoint 计费规则预估请求。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。