问答
怎么用 API 按关键词搜 YouTube 频道,顺带拿到订阅数?
简短回答
用 okdata 的 YouTube 频道搜索,每页 20 个频道,结果里就有订阅数,每页 $0.004,按订阅区间筛选不用再查一遍;再用 YouTube 频道视频接口拉每个频道最新的约 30 条视频和播放数,每页 $0.002。找 200 个订阅 1 万到 50 万的美食频道、每个看最近 30 条视频,一共 $0.56,没有每日配额,也不用建 Google Cloud 项目。用官方 Data API 也做得完:search.list 设 type=channel、maxResults=50,订阅数从 channels.list 读,视频走频道的上传播放列表,别对每个频道单独调一次 search.list,这样一天的默认配额就够。
一个做厨具出海的品牌,想在美国和英国找 200 个美食频道合作。订阅数要在 1 万到 50 万之间:太小没量,太大不回邮件。每个频道还要看最近 30 条视频的播放,因为最近的播放比订阅数更能说明这个频道现在有多少人看。名单还不存在,只能从关键词开始搜。
官方 Data API 的配额花在哪
按 Google 配额页面的说法(2026-11-17 查阅),每个项目每天有 100 次 search.list,单独算一个桶;其他接口共用每天 10,000 个单位,channels.list、playlistItems.list、videos.list 每次各 1 个单位。搜索结果每多翻一页,就多算一次调用。搜索配额为什么不够用,这篇讲过。找频道这件事,配额够不够主要看下面几步怎么调:
| 步骤 | 官方接口 | 算在哪个桶 | 这个任务要用 |
|---|---|---|---|
| 找频道 | search.list,type=channel,maxResults=50 |
每天 100 次搜索 | 10 个关键词 × 2 页 = 20 次 |
| 订阅数和上传播放列表 | channels.list,part=statistics,contentDetails,ID 用逗号拼在一起 |
10,000 单位 | 每个候选频道最多 1 单位,批量查更少 |
| 最近的视频 | playlistItems.list,读 contentDetails.relatedPlaylists.uploads |
10,000 单位 | 200 |
| 这些视频的播放数 | videos.list,part=statistics |
10,000 单位 | 200 |
照这样跑一遍,100 次搜索只用 20 次,10,000 个单位用不到五分之一。最常见的两个坑:一是 maxResults 没改,默认每页只有 5 条,1,000 个候选频道就要搜 200 次,等于两天的配额;二是用 search.list 加 channelId 去列每个频道的视频,一个频道花一次搜索,200 个频道同样要两天。搜索结果里本来就没有订阅数,snippet 只有标题、简介和缩略图,所以 channels.list 这一步省不掉。它返回的 subscriberCount 怎么取整,见 YouTube 频道订阅数。
用 okdata 做同一件事
- 搜频道。YouTube 频道搜索传
query,每页按 YouTube 的顺序返回 20 个频道:id(UC 开头的频道 ID)、name、bio(简介开头)、avatar_url和followers。followers就是页面上显示的订阅数,245K 会返回成 245000。翻页用cursor。 - **筛选。**只留
followers落在区间里的频道,再按id去重。同一个频道经常会在好几个关键词下出现。 - 拉视频。YouTube 频道视频传频道
id,返回最新的约 30 条视频,有标题、metrics.views和大概的发布时间published_at。一页大约就是最近 30 条。加type=short换成这个频道的 Shorts。 - **按国家筛(可选)。**频道搜索不能按地区过滤。YouTube 频道资料加
view=full会返回ext.country、总播放量和注册日期,拿它只留美国和英国的频道。
频道搜索的结果和在 YouTube 上搜索再筛选“频道”看到的差不多。有些博主做菜做得很好,频道名里却没有 recipe 这类词。想把他们也找出来,就用同样的关键词跑一遍 YouTube 视频搜索(每页约 20 条视频,$0.004),从结果里收集 author.id。视频搜索的结果不带订阅数,新冒出来的频道再用频道资料接口查一下。
import csv, os, statistics, requests
API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
def get(path, **params):
body = requests.get(API + path, headers=H, params=params, timeout=60).json()
if body["code"] != "ok":
raise RuntimeError(f"{body['code']}: {body['message']}")
return body
PHRASES = ["easy dinner recipes", "meal prep", "home baking", "vegan cooking", "air fryer recipes",
"one pot meals", "sourdough", "budget cooking", "healthy recipes", "weeknight dinners"]
LOW, HIGH, WANT = 10_000, 500_000, 200
found = {}
for q in PHRASES:
cursor = None
for _ in range(4): # 每个关键词翻 4 页
body = get("/v1/youtube/channels/search", query=q, **({"cursor": cursor} if cursor else {}))
for ch in body["data"]["items"]:
if ch["followers"] is not None and LOW <= ch["followers"] <= HIGH:
found.setdefault(ch["id"], ch)
if not body["page"]["has_more"]:
break
cursor = body["page"]["next_cursor"]
with open("cooking_channels.csv", "w", newline="", encoding="utf-8") as f:
w = csv.writer(f)
w.writerow(["channel_id", "name", "subscribers", "videos_read", "median_views"])
for ch in list(found.values())[:WANT]:
vids = get("/v1/youtube/channels/videos/list", id=ch["id"])["data"]["items"]
views = [v["metrics"]["views"] for v in vids if v["metrics"]["views"] is not None]
w.writerow([ch["id"], ch["name"], ch["followers"], len(vids),
int(statistics.median(views)) if views else ""])
这个任务花多少钱
| 步骤 | 调用次数 | 费用 |
|---|---|---|
| 频道搜索,10 个关键词 × 4 页(最多 800 条) | 40 | $0.16 |
| 200 个频道各拉最近约 30 条视频 | 200 | $0.40 |
| 合计 | 240 | $0.56 |
| 可选:200 个频道的国家、总播放量和注册日期 | 200 | $0.40 |
| 1,000 条频道搜索结果 | 50 | $0.20 |
800 条结果里落在区间内的不到 200 个,就多加几个关键词。按次付费,没有订阅,每个接口的价格都列在价格页,新 key 自带 $0.10 试用额度。
交给 Agent 去做
在 Claude、Cursor 或其他支持 MCP 的客户端里,填上 MCP 服务地址 https://api.okdata.online/mcp 和你的 key,然后直接问:“找 50 个订阅 1 万到 50 万、做家庭烘焙的 YouTube 频道,给出每个频道最近 30 条视频的播放中位数。”Agent 调的就是上面这两个接口。开始前让它先说打算翻几页。
局限
- 订阅数按 YouTube 页面的方式取整。官方的
subscriberCount也向下取整到三位有效数字,哪条路都拿不到精确值。隐藏了订阅数的频道,followers返回 null。 - 频道搜索不能按语言、地区或订阅数过滤。关键词用目标市场的语言写,订阅区间自己按
followers筛。 - 搜索结果里没有用户名、认证标识和视频数,这些要查频道资料接口。频道 ID 和 @用户名该存哪个,见这篇。
- 视频列表只能从新到旧排,发布时间是“3 周前”这种大概值,也没有点赞数和评论数。
type=short返回的 Shorts 没有发布时间。
什么时候官方 API 更合适
只做一次名单,按上面的表调官方 API,默认配额就够用。官方还有这里没有的东西:搜索可以用 regionCode 和 relevanceLanguage 过滤,上传播放列表里有精确的发布时间。下面几种情况用 okdata 更省事:每天 100 次搜索不够,比如每天在很多品类、很多市场里找新频道;不想自己维护 Google Cloud 项目和 key;或者让 Agent 去搜。同样的方法用在别的平台上,见找达人。
资料来源
- YouTube Data API: Quota Calculator (default allocation, search.list bucket)
- YouTube Data API: Search: list (type, maxResults, quota impact)
- YouTube Data API: Channels resource (statistics, uploads playlist)
- YouTube Data API: PlaylistItems: list
- YouTube Data API: PlaylistItems resource (videoPublishedAt)
- YouTube Data API: Videos: list
这个问题出现过的地方(读取于 2026-11-17)
更新于