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
用关键词搜索,分页读取匹配的频道。
- 向 /v1/youtube/search-channels 发送 {"query": "home cooking", "results_limit": 20}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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,看看有没有公开的商务联系方式。
相关 API
除了 YouTube Channel Search API,需要其他类型的 YouTube 公开数据时,可以使用以下 API。
- YouTube Channel Videos API — 通过频道 URL 采集公开普通视频,不包含 Shorts 和直播。
- YouTube Channels API — 获取公开频道身份、图片、认证状态和可见受众统计。
- YouTube Search API — 按关键词搜索公开普通视频,并支持元数据筛选。
- YouTube Hashtag Search API — 从话题标签信息流发现公开视频,可采集全部内容或仅采集 Shorts。
- YouTube Shorts Search API — 按关键词搜索 Shorts,返回链接、文案、播放量和竖版缩略图。
- YouTube Email Finder API — 按频道 URL 查找公开的商务邮箱,并标明每个邮箱出现在哪些页面。
- YouTube Comments API
- YouTube Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Trending Videos API