youtube/
search-channels

按关键词搜索 YouTube 频道,按搜索排序返回频道 ID、名称、订阅数、头像,以及 YouTube 展示的简介片段。

YouTube Channel Search API

关键词输入
订阅数
最多 200 个频道
每条结果 0.6 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

YouTube Channel Search

频道搜索结果是 YouTube 按关键词匹配出的创作者账号,每个都列出名称、头像、订阅数和简介开头的几句话。浏览这些结果,最快就能弄清某个话题由谁在做、哪些是大频道哪些在成长,并为达人调研或建联整理出第一份名单。

YouTube Channel Search API 主要特性

  • 只搜频道搜索范围限定为频道,输入 home cooking 这样的关键词,得到的就是创作者账号,不会混进视频和播放列表。
  • 每个频道的订阅数metrics.followers_count 是从 YouTube 展示的 3.69M 这类文本换算出的订阅总数。
  • 稳定的频道 ID 和链接每条结果都带 UC 开头的频道 ID 和由它组成的频道链接,可以直接交给频道类接口。
  • 简介片段text 是搜索结果里展示的简介摘录,常常写明频道定位,有时还带有商务联系方式。

YouTube Channel Search API 参数

参数必填描述
query必填用来查找频道的关键词,最多 100 个字符。
results_limit可选返回的频道数量,取值 1 到 200,默认 20。

如何使用 YouTube Channel Search API

用关键词搜索,分页读取匹配的频道。

  1. 向 /v1/youtube/search-channels 发送 {"query": "home cooking", "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/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home cooking","results_limit":20}'

# 每条结果是一个频道,包含 name、text 和 metrics.followers_count。

YouTube Channel Search API 最佳使用场景

  • 整理达人候选名单: 搜索所在领域的关键词,留下 followers_count 落在合作量级范围内的频道。
  • 看清话题由谁主导: 对比一个关键词下排名靠前频道的订阅数,判断这个话题是否被少数大频道占据。
  • 为频道调研打底: 把返回的频道链接交给 YouTube Channels 和 YouTube Channel Videos,逐个深入了解创作者。

YouTube Channel Search API 使用建议

  • 订阅数来自四舍五入的展示文本,需要精确到个位时用 YouTube Channels 查询。
  • 同一个话题换几种说法分别搜索,再按频道 id 合并,名单会更全。
  • 把看好的频道交给 YouTube Email Finder,看看有没有公开的商务联系方式。

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

探索其他平台

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

YouTube Channel Search API — 常见问题

YouTube Channel Search API 是一个用于按关键词查找 YouTube 频道的 API。它按 YouTube 的搜索排序返回频道 ID、名称、订阅数、头像和简介片段。

results_limit 可设为 1 到 200,默认 20。结果会自动翻页,直到达到上限或 YouTube 没有更多结果。

搜索结果用 UC 开头的频道 ID 和频道链接来标识频道。把链接交给 YouTube Channels,就能拿到账号名和完整资料。

不需要。请求用的是你的 SocQ API key,按返回的频道数扣积分,不用建 Google Cloud 项目,也不用管理每日配额。

每返回一个频道计 0.6 积分,默认的 20 个共计 12 积分。