SocQ 早已支持公开的 YouTube 频道、视频、Shorts、评论、搜索、播放列表和字幕。7 个最佳 YouTube Scraper API 对这些做了对比,YouTube 字幕指南 介绍了批量获取字幕文本。2026-11-17,又有 8 个接口上线到 YouTube 平台页。它们补上了 Shorts 研究、达人发现与外联,以及创作者在两次上传之间发布的社区帖子这几块。
本文按用途对新接口分组,每个接口给出一条请求示例,并列出价格和适用场景。
快速回答: 向
POST https://api.socq.ai/v1/youtube/<endpoint>发送 JSON 请求体。保存返回的task_id,轮询GET /v1/tasks/{task_id}直到status为succeeded,再读取data.results.items。
新 YouTube 接口一览
1 SocQ credit = $0.005。按结果计费的接口没有基础费用,结果为空时不收费。
| 接口 | 返回内容 | 价格 |
|---|---|---|
| YouTube 热门 Shorts API | 新鲜抽样的热门 Shorts,含频道、播放、点赞、评论、时长和发布时间 | 每条 Short 0.5 credits($0.0025) |
| YouTube Shorts 搜索 API | 关键词对应的 Shorts,含链接、文案、播放量和竖版缩略图 | 每条 Short 0.6 credits($0.003) |
| YouTube 频道搜索 API | 关键词对应的频道,含 ID、名称、订阅数、头像和简介摘要 | 每个频道 0.6 credits($0.003) |
| YouTube 搜索联想词 API | 部分搜索词的联想建议,按排名,可选语言和地区 | 每次调用 0.5 credits($0.0025) |
| YouTube 社区帖子详情 API | 一条社区帖子:全文、所有图片、点赞数和频道 | 每次调用 0.5 credits($0.0025) |
| YouTube 社区帖子评论 API | 社区帖子下的评论,含评论者、点赞数和回复数 | 每条评论 0.3 credits($0.0015) |
| YouTube 相关视频 API | YouTube 在某个视频旁推荐的视频 | 每条视频 0.5 credits($0.0025) |
| YouTube 频道邮箱查找 API | 频道公开的商务邮箱及其出处页面 | 找到邮箱的频道每个 15 credits($0.075);未找到时免费 |
认证与异步任务流程
所有请求都用 API key 认证。提交、查询任务状态和读取结果使用同一个请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
每次采集都作为后台任务运行:
submit -> task_id -> queued -> running -> succeeded
\-> failed
提交请求会立即返回 data.task_id 和 data.status。用这个 ID 轮询任务:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
当 status 为 succeeded 时,响应包含 result_count、credits_amount,以及 data.results.items 中第一页标准化记录。limit 默认 50,最大 500。如果 results.has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。失败的任务带有 error_message。
下面每个接口都接受可选的 callback_url。任务结束后,SocQ 会发送一次带任务摘要的 POST;记录仍从任务接口读取。客户端超时不会取消任务,请用同一个任务 ID 继续读取,不要重新提交。402 表示账户余额不足,429 表示 key 触发了频率或额度限制。
研究 Shorts 和搜索需求
热门 Shorts 抽样 YouTube 当前作为热门推送的 Shorts,每条含标题、频道、播放、点赞、评论、时长和发布时间。所有字段都是可选的;results_limit 默认 48,最多 200。每次运行都会重新抽样,相隔几分钟的两次运行只有少量 Shorts 重合。因此定时任务比一次大调用更能拼出全天的全貌。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"results_limit": 48}'
Shorts 搜索 按 YouTube 的搜索顺序返回关键词对应的 Shorts,含链接、文案、播放量和竖版缩略图。搜索结果只有这些基础信息,如果还需要点赞、评论或频道详情,请把保留的链接交给 YouTube Videos。results_limit 默认 25(1 到 200)。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "meal prep", "results_limit": 25}'
搜索联想词 返回 YouTube 搜索框为搜索词开头提供的补全,按观众看到的顺序排名。language 默认 en,region 默认 US;切换它们可以看到同一个种子词在其他市场如何展开。每次调用计费一次,与返回的联想词数量无关。适合做关键词研究、标题和标签。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "iphone 17"}'
发现达人并找到联系邮箱
频道搜索 按 YouTube 的顺序查找关键词对应的频道,含频道 ID、名称、订阅数、头像和搜索结果中显示的简介摘要。results_limit 默认 20(1 到 200)。这是达人发现的第一步:在这里建立候选名单,再用 YouTube Channels 拉取详情,或用 YouTube Channel Videos 拉取上传的视频。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "home cooking", "results_limit": 20}'
频道邮箱查找 查找创作者公开的商务邮箱:在频道简介、关联的社交主页、link-in-bio 页面或创作者自己的网站上。emails 中每个地址都附带发现它的 source_urls。url 接收 @handle 或 /channel/UC... 格式的频道链接。至少有一个公开邮箱的频道返回一条结果,包含找到的所有地址,费用 15 credits($0.075);没有列出邮箱的频道返回空结果,不收费。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/@mkbhd"}'
成本示例: 搜索 20 个频道(12 credits),再对这 20 个频道运行邮箱查找。如果其中 8 个列出了邮箱,就是 120 credits,合计 132 credits($0.66)。没有公开邮箱的 12 个频道不收费。
读取社区帖子及其评论
社区帖子详情 根据链接读取一条帖子:全文、所有附图、点赞数和发帖频道。url 接收 https://www.youtube.com/post/{post_id} 链接,或带 ?lb={post_id} 的频道帖子链接。适用于你手上已有帖子 URL 的情况,例如来自 YouTube Community Posts 的结果。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'
社区帖子评论 采集帖子(例如投票、公告或图片)下的评论,含每位评论者的频道、metrics.likes_count 和 metrics.replies_count。帖子评论与视频评论是分开的,所以要了解观众对创作者两次上传之间动态的反应,就要看这里。支持相同的 URL 格式;results_limit 默认 100(1 到 1000)。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'
看看 YouTube 接下来推荐什么
相关视频 返回 YouTube 放在视频旁边的“接下来观看”列表:标题、频道、播放量和缩略图。url 接收 watch、youtu.be、Shorts 或直播链接。一次运行返回整个推荐列表,通常约 20 条视频,按视频计费,因此一次典型调用约 10 credits($0.05)。对自己或竞品的视频运行它,可以看到 YouTube 把哪些视频和频道当作它们的“邻居”。(文档)
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
相关 YouTube 指南
要把 SocQ 与其他 YouTube 数据服务商对比,见 19 个最佳 YouTube API 替代方案。在 TikTok 上做同样的发现与外联流程,包括粉丝国家分布和刷量检测,见 TikTok 新接口指南。
常见问题
没有公开邮箱的频道会收费吗?
不会。没有公开邮箱的频道返回空结果,免费。至少有一个邮箱的频道收费 15 credits,无论列出多少个地址。
为什么两次运行热门 Shorts 返回的内容不同?
每次运行都抽样当时的热门内容,相隔几分钟的两次运行只有少量 Shorts 重合。想要更广的覆盖,请安排多次运行。
支持哪些社区帖子 URL?
https://www.youtube.com/post/{post_id},或带 ?lb={post_id} 的频道帖子链接。
Shorts 搜索会返回点赞和评论吗?
不会。搜索结果只有链接、文案、播放量和缩略图。需要点赞、评论和频道详情时,把链接交给 YouTube Videos。
搜索联想词如何计费?
每次调用 0.5 credits,与返回的联想词数量无关。