seo/
youtube-serp

查看 YouTube 在你选择的国家和语言下为某个搜索词列出的视频,按排名顺序返回每个视频的标题、频道、播放量、时长、缩略图和发布日期。

YouTube Rank Tracker API

排名顺序
排名视频
频道与播放量
任意国家和语言
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

YouTube Rank Tracker

YouTube 搜索排名是 YouTube 在特定国家和语言下为一个搜索词展示的视频顺序,它决定了人们搜索某个话题时会发现哪些视频。针对目标关键词跟踪这些排名,可以看到频道的视频排在哪里、各市场里哪些频道占据了某个话题、排在前面的视频有多新多长,以及哪些关键词的结果偏弱、值得争取。

YouTube Rank Tracker API 主要特性

  • 按排名顺序的视频行的顺序就是 YouTube 对该搜索词的排序,每行是一个视频,含视频 id、观看链接 url,标题在 text 中。
  • 每个视频背后的频道author 包含频道 id、名称、url 和头像,可以按频道汇总排名。
  • 播放量、时长和发布日期metrics.views_count、duration_seconds 和 published_at 分别说明每个上榜视频有多热门、多长、多新。
  • 每条结果都有缩略图media 里有视频缩略图,可直接做成结果页的可视化报告。
  • 分市场的排名设定搜索的国家和语言,用 results_limit 读取 1 到 200 个视频。

YouTube Rank Tracker API 参数

参数必填描述
query必填在 YouTube 上搜索的关键词,例如 crm tutorial。
location_code可选搜索市场的地区代码,默认 2840(美国)。
location_name可选市场名称,可代替 location_code;填写后优先于 location_code。
language_code可选搜索语言代码,默认 en。
language可选语言名称,可代替 language_code;填写后优先于 language_code。
results_limit可选返回视频数上限,1–200,默认 20。

如何使用 YouTube Rank Tracker API

提交搜索词,按排名顺序每个视频读取一行。

  1. 向 /v1/seo/youtube-serp POST {"query": "crm tutorial", "location_code": 2840, "language_code": "en", "results_limit": 20}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 按顺序从 results.items 读取视频;has_more 为 true 时用 results.next_cursor 请求下一页。
curl -X POST "https://api.socq.ai/v1/seo/youtube-serp" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"crm tutorial","location_code":2840,"language_code":"en","results_limit":20}'

YouTube Rank Tracker API 最佳使用场景

  • 追踪自家视频的关键词排名: 定期查询目标关键词,记录 author id 为自己频道的每个视频所在的位置。
  • 看清哪些频道占据了话题: 统计一组关键词结果中各个 author 出现的次数,画出各市场主导某个话题的频道分布。
  • 找到值得争取的关键词: 寻找排在前面的视频 views_count 偏低或 published_at 较早的搜索词,这说明一个优质的新视频有机会排上去。
  • 规划视频时长和形式: 对比排名靠前视频的 duration_seconds,看 YouTube 在某个话题下更青睐多长的视频。

YouTube Rank Tracker API 使用建议

  • 保存排名时,把每个视频在返回结果中的位置和搜索词、市场、日期一起记录,因为返回顺序就是排名。
  • 匹配自己的视频时,比对 author.id 而不是频道名称,频道名称可能会改。
  • 只关注首屏结果时,results_limit 保持在 20 左右即可,因为每个视频计 0.5 积分。

除了 YouTube Rank Tracker API,需要其他类型的 SEO 公开数据时,可以使用以下 API。

  • Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页,返回标准化目标地址、排名、元素类型和完整结果详情。
  • Keyword Difficulty API — 比较一批输入关键词的自然排名难度,为每个有可用数据的关键词返回标准化分数。
  • Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
  • Keyword Search Volume API — 测量已知关键词可用的搜索量、CPC、付费竞争和月度搜索历史。
  • Keywords for Site API — 根据一个网站生成相关关键词,并返回可用的需求指标、月度历史、市场上下文和完整来源记录。
  • Google Autocomplete API — 获取 Google 针对搜索词开头给出的联想补全,保持 Google 的顺序,可选任意国家和语言。

探索其他平台

还可以将 SEO 数据与其他已支持社交平台的公开数据结合使用。

YouTube Rank Tracker API — 常见问题

YouTube Rank Tracker API 按所选国家和语言,以排名顺序返回 YouTube 为某个搜索词列出的视频,附每个视频的标题、频道、播放量、时长、缩略图和发布日期。

是的。每一行是一条按搜索顺序排名的视频,发布它的频道在 author 中。

results_limit 可设 1 到 200,默认 20。

每返回一个视频计 0.5 积分。