# YouTube 搜索 API：按关键词查找视频和频道

从你的 agent 发起 YouTube 搜索，把结果作为数据拿回来：标题、视频 ID、频道、发布日期和缩略图，并支持站点本身提供的筛选条件。10 款工具都通过 鹦鹉AI 完成这件事。Google 的官方 API 对搜索配额最紧，这正是其他工具存在的原因。

## 怎么让 鹦鹉AI 做这件事？

安装行（粘到任意 agent）：`set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

然后说：「使用 鹦鹉AI，在 YouTube 上搜索过去一个月上传的、关于家用意式咖啡的视频，按播放量排序。先告诉我价格，然后给我前 20 条及链接。」

- **说清搜什么** 就是一个关键词，和你往站点搜索框里输入的方式一样。
- **指定筛选条件** 上传日期、时长、类型和排序方式在每款工具上都是参数。
- **说明要视频还是频道** 同一个查询两种都能返回。说清楚要哪种，否则会混在一起。
- **统计数字要单独取** 搜索结果不含播放量。agent 需要再取一次。

## 为什么走鹦鹉AI

- **不订阅，不买席位** 按次计费。不用绑卡、没有最低消费；给预付余额充值即可。
- **换个工具只是换一个词** 提示词里换一个词就是另一款工具，而不是一次新的集成。

端点：

- `justoneapi.x.youtube-search-v1` — 按关键词搜索 YouTube (youtube): https://parrot.amorist.cn/catalog/youtube
- `scrapecreators.x.v1-youtube-search` — 按关键词搜索 YouTube — 视频、频道、播放列表 (youtube): https://parrot.amorist.cn/catalog/youtube
- `tikhub.x.youtube-web-v2-get-general-search` — 按关键词和筛选条件搜索 YouTube (youtube): https://parrot.amorist.cn/catalog/youtube
- `tikhub.x.youtube-web-search-video` — 按关键词搜索 YouTube 视频 (youtube): https://parrot.amorist.cn/catalog/youtube
- `youtube.youtube.search.videos` — 按关键词搜索 YouTube 视频 (youtube): https://parrot.amorist.cn/catalog/youtube
- `tikhub.youtube.search.videos` — 按关键词和筛选条件搜索 YouTube 视频 (youtube): https://parrot.amorist.cn/catalog/youtube
- `crawl4ai.youtube.search.videos` — YouTube 搜索结果 (youtube): https://parrot.amorist.cn/catalog/youtube
- `serpapi.youtube.search.videos` — 按查询词搜索 YouTube 视频 — 播放量、频道 (youtube): https://parrot.amorist.cn/catalog/youtube
- `tikhub.x.youtube-web-search-channel` — 在 YouTube 频道内按关键词搜索 (youtube): https://parrot.amorist.cn/catalog/youtube
- `tikhub.x.youtube-web-v2-search-channels` — 按关键词搜索 YouTube 频道 (youtube): https://parrot.amorist.cn/catalog/youtube

## 大家实际卡在哪

这是免费路线最先撞墙的任务，而撞过墙的人对原因说得异常精确。我们从 2026 年 8 月 Reddit 和 X 上约 180 条帖子中，剔除了推广账号群。

**一个数字决定了这一整页**

> "官方 Data API v3 的 search.list 有硬性的每日上限，一旦你轮询多个关键词组合，额度几乎立刻就没了" (r/webscraping, 7 points: https://www.reddit.com/r/webscraping/comments/1uaq3lk/keywordsearching_youtube_at_scale_official_api_vs/)

这一页能帮上的： 完全正确。搜索正是耗尽官方每日额度的那个方法，而且还没算上给结果补播放量所花的额度。这个差距就是那些付费工具存在的原因。

**用硬上限换一个未知的上限**

> "在 InnerTube 路线上，大概多高的请求频率会被限流或软封？" (r/webscraping, 7 points: https://www.reddit.com/r/webscraping/comments/1uaq3lk/keywordsearching_youtube_at_scale_official_api_vs/)

这一页能帮上的： 调研里没人知道，提问的人自己也不知道，我们同样不知道。我们能说的是：请求是从工具的基础设施而不是你的出去。这就是对这个问题诚实的回答版本。

**搜索结果不是人看到的那份**

> "我想要一个 API 或抓取工具，能复现我在手机上搜索时看到的同样结果。有办法吗？" (r/n8n, 1 point: https://www.reddit.com/r/n8n/comments/1rkmsj4/youtube_scraper/)

这一页能帮上的： 没有，谁都做不到完全一样。站上的排名是个性化的、按地区分化的，而且是在登录状态下给出的；这些调用一样都不是。传入地区和语言能更接近某个市场。没有哪款工具能告诉你谁的排序跟你的用户一致，所以花不到 1 积分拿你自己的查询跑两个工具，把两份列表对一下。

**agent 默认会写出那个昂贵的版本**

> "问题是我的播放列表里有 1.2k 首歌，但我只能转移大约 60 首，之后就开始报错" (r/learnpython: https://www.reddit.com/r/learnpython/comments/1hk199a/help_needed_exceeded_youtube_api_quota_while/)

这一页能帮上的： ChatGPT 给他们写了个每首歌搜一次的循环，到第 100 首歌这个项目就死了。这正是这一页真正要讲的失败：代码本身没问题，没人读的是配额模型。先让 agent 报出价格，它就能在开跑之前告诉你这一趟跑不起。

**真正的任务是扫一遍，不是搜一下**

> "于是我写了个 Python 脚本，抓某个细分领域（AI 儿童睡前故事）的 YouTube Shorts，拉统计数据、字幕" (r/shortsAlgorithm, 78 points: https://www.reddit.com/r/shortsAlgorithm/comments/1rh2bek/i_scraped_53_youtube_shorts_from_a_single_niche/)

这一页能帮上的： 搜索，然后详情，然后字幕，覆盖一个细分领域，按计划定时跑。这是这份菜单上三个任务串起来，也几乎就是所有做这件事的人真正想要的。按次计价让这次扫荡变成可以事先估算的东西，而不是一个你一点点摸到边界的配额。

## 真正不一样的地方

- 搜索结果在任何工具上都不带统计数据。想按播放量给你的结果排序，就要拿视频 ID 去调用「视频详情」这个任务；做预算时要按两步算，而不是一步。
- SerpApi 的参数是 search_query，不是 q。向它的 YouTube 引擎传 q 不会报错，而是返回空，这类失败看起来就像一个空结果集。

## YouTube 搜索 API 返回什么？

一页结构化的搜索结果记录：视频 ID、标题、描述片段、频道名和频道 ID、发布日期和缩略图，外加一个用于获取下一页的 token。它是站点自己的排名，而不是一份全新的索引，所以结果会和 YouTube 上一样变动，相隔几分钟的两次调用也可能合理地不同。

## 开始之前

**可以只搜索某一个频道的视频吗？** 可以。Google 的搜索接受 channelId，TikHub 有一个端点可以按 ID 在频道内搜索。每款工具的文档会说明哪个端点做哪件事。

**搜索结果包含播放量吗？** 任何工具都不包含。那需要第二次调用「视频详情」任务，这一步便宜且支持批量，所以让 agent 两件事一起做，它会串起来。

**这和用户看到的排名一样吗？** 接近，但不能保证。站点上的结果是因人而异、因地区而异的，而这些调用不是以你的身份登录的。传入地区和语言，才能更接近某个特定市场。

HTML 版本： https://parrot.amorist.cn/use-cases/search-videos-and-channels-by-keyword