给 AI

问答

怎么用 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 做同一件事

  1. 搜频道。YouTube 频道搜索传 query,每页按 YouTube 的顺序返回 20 个频道:id(UC 开头的频道 ID)、name、bio(简介开头)、avatar_url 和 followers。followers 就是页面上显示的订阅数,245K 会返回成 245000。翻页用 cursor。
  2. **筛选。**只留 followers 落在区间里的频道,再按 id 去重。同一个频道经常会在好几个关键词下出现。
  3. 拉视频。YouTube 频道视频传频道 id,返回最新的约 30 条视频,有标题、metrics.views 和大概的发布时间 published_at。一页大约就是最近 30 条。加 type=short 换成这个频道的 Shorts。
  4. **按国家筛(可选)。**频道搜索不能按地区过滤。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 去搜。同样的方法用在别的平台上,见找达人。

资料来源

  1. YouTube Data API: Quota Calculator (default allocation, search.list bucket)developers.google.com · 读取于
  2. YouTube Data API: Search: list (type, maxResults, quota impact)developers.google.com · 读取于
  3. YouTube Data API: Channels resource (statistics, uploads playlist)developers.google.com · 读取于
  4. YouTube Data API: PlaylistItems: listdevelopers.google.com · 读取于
  5. YouTube Data API: PlaylistItems resource (videoPublishedAt)developers.google.com · 读取于
  6. YouTube Data API: Videos: listdevelopers.google.com · 读取于

这个问题出现过的地方(读取于 2026-11-17)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp