# 怎么用 API 按关键词搜 YouTube 频道，顺带拿到订阅数？

> 按关键词搜 YouTube 频道，结果里直接带订阅数，筛出想要的订阅区间，再拉每个频道最近的视频。官方 Data API 配额怎么算、Python 代码和价格。

网页版：https://okdata.online/zh/answers/youtube-channel-search-api/

**简短回答：**用 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 个单位。搜索结果每多翻一页，就多算一次调用。搜索配额为什么不够用，[这篇](/zh/answers/youtube-search-quota-exceeded/)讲过。找频道这件事，配额够不够主要看下面几步怎么调：

| 步骤 | 官方接口 | 算在哪个桶 | 这个任务要用 |
|---|---|---|---|
| 找频道 | `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 频道订阅数](/zh/answers/youtube-channel-subscriber-count-api/)。

## 用 okdata 做同一件事

1. **搜频道。**[YouTube 频道搜索](/zh/apis/youtube/channels/search/)传 `query`，每页按 YouTube 的顺序返回 20 个频道：`id`（UC 开头的频道 ID）、`name`、`bio`（简介开头）、`avatar_url` 和 `followers`。`followers` 就是页面上显示的订阅数，245K 会返回成 245000。翻页用 `cursor`。
2. **筛选。**只留 `followers` 落在区间里的频道，再按 `id` 去重。同一个频道经常会在好几个关键词下出现。
3. **拉视频。**[YouTube 频道视频](/zh/apis/youtube/channels/videos/list/)传频道 `id`，返回最新的约 30 条视频，有标题、`metrics.views` 和大概的发布时间 `published_at`。一页大约就是最近 30 条。加 `type=short` 换成这个频道的 Shorts。
4. **按国家筛（可选）。**频道搜索不能按地区过滤。[YouTube 频道资料](/zh/apis/youtube/channels/get/)加 `view=full` 会返回 `ext.country`、总播放量和注册日期，拿它只留美国和英国的频道。

频道搜索的结果和在 YouTube 上搜索再筛选“频道”看到的差不多。有些博主做菜做得很好，频道名里却没有 recipe 这类词。想把他们也找出来，就用同样的关键词跑一遍 [YouTube 视频搜索](/zh/apis/youtube/videos/search/)（每页约 20 条视频，$0.004），从结果里收集 `author.id`。视频搜索的结果不带订阅数，新冒出来的频道再用频道资料接口查一下。

```python
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 个，就多加几个关键词。按次付费，没有订阅，每个接口的价格都列在[价格页](/zh/pricing/)，新 key 自带 $0.10 试用额度。

## 交给 Agent 去做

在 Claude、Cursor 或其他支持 MCP 的客户端里，填上 [MCP 服务](/zh/mcp/)地址 https://api.okdata.online/mcp 和你的 key，然后直接问：“找 50 个订阅 1 万到 50 万、做家庭烘焙的 YouTube 频道，给出每个频道最近 30 条视频的播放中位数。”Agent 调的就是上面这两个接口。开始前让它先说打算翻几页。

## 局限

- 订阅数按 YouTube 页面的方式取整。官方的 `subscriberCount` 也向下取整到三位有效数字，哪条路都拿不到精确值。隐藏了订阅数的频道，`followers` 返回 null。
- 频道搜索不能按语言、地区或订阅数过滤。关键词用目标市场的语言写，订阅区间自己按 `followers` 筛。
- 搜索结果里没有用户名、认证标识和视频数，这些要查频道资料接口。频道 ID 和 @用户名该存哪个，见[这篇](/zh/answers/youtube-video-channel-id-handle/)。
- 视频列表只能从新到旧排，发布时间是“3 周前”这种大概值，也没有点赞数和评论数。`type=short` 返回的 Shorts 没有发布时间。

## 什么时候官方 API 更合适

只做一次名单，按上面的表调官方 API，默认配额就够用。官方还有这里没有的东西：搜索可以用 `regionCode` 和 `relevanceLanguage` 过滤，上传播放列表里有精确的发布时间。下面几种情况用 okdata 更省事：每天 100 次搜索不够，比如每天在很多品类、很多市场里找新频道；不想自己维护 Google Cloud 项目和 key；或者让 Agent 去搜。同样的方法用在别的平台上，见[找达人](/zh/solutions/creator-discovery/)。

## 用到的接口

- [YouTube 频道搜索](https://okdata.online/zh/apis/youtube/channels/search/) `youtube.channels.search`：$0.004/次 · 每页约 20 个账号
- [YouTube 频道视频](https://okdata.online/zh/apis/youtube/channels/videos/list/) `youtube.channels.videos.list`：$0.002/次 · 每页约 30 条视频
- [YouTube 频道资料](https://okdata.online/zh/apis/youtube/channels/get/) `youtube.channels.get`：$0.002/次
- [YouTube 视频搜索](https://okdata.online/zh/apis/youtube/videos/search/) `youtube.videos.search`：$0.004/次 · 每页约 20 条视频

## 更多YouTube内容

- [YouTube API](https://okdata.online/zh/apis/youtube/)
- [怎么导出某个话题下所有 YouTube 视频的评论](https://okdata.online/zh/guides/youtube-comments-export/)
- [怎么按关键词搜 YouTube 视频并拿到字幕](https://okdata.online/zh/guides/youtube-video-transcript/)
- [怎么用 API 查 YouTube 频道的订阅数和频道数据？](https://okdata.online/zh/answers/youtube-channel-subscriber-count-api/)
- [几百个 YouTube 视频的字幕怎么批量下载？](https://okdata.online/zh/answers/bulk-youtube-transcripts/)
- [跑一个社媒数据任务之前，怎么提前知道要花多少钱？](https://okdata.online/zh/answers/estimate-data-api-cost-before-running/)
- [用平台官方 API 还是第三方社媒数据接口？](https://okdata.online/zh/answers/official-api-vs-third-party-social-data/)
- [有没有一个 API 能同时监测品牌在 TikTok、YouTube 和 X 上的讨论？](https://okdata.online/zh/answers/social-listening-api-tiktok-youtube-x/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)

## 资料来源

- [YouTube Data API: Quota Calculator (default allocation, search.list bucket)](https://developers.google.com/youtube/v3/determine_quota_cost) (读取于 2026-11-17)
- [YouTube Data API: Search: list (type, maxResults, quota impact)](https://developers.google.com/youtube/v3/docs/search/list) (读取于 2026-11-17)
- [YouTube Data API: Channels resource (statistics, uploads playlist)](https://developers.google.com/youtube/v3/docs/channels) (读取于 2026-11-17)
- [YouTube Data API: PlaylistItems: list](https://developers.google.com/youtube/v3/docs/playlistItems/list) (读取于 2026-11-17)
- [YouTube Data API: PlaylistItems resource (videoPublishedAt)](https://developers.google.com/youtube/v3/docs/playlistItems) (读取于 2026-11-17)
- [YouTube Data API: Videos: list](https://developers.google.com/youtube/v3/docs/videos/list) (读取于 2026-11-17)

这个问题出现过的地方（读取于 2026-11-17）：

- https://stackoverflow.com/questions/79020278
- https://stackoverflow.com/questions/70125353
- https://stackoverflow.com/questions/66035288

更新于 2026-11-17
