做海外内容调研时，一个常见任务是寻找某个领域的 YouTube 创作者。手动操作并不复杂：搜索关键词，打开视频，进入频道主页，再记录订阅量、地区和公开联系方式。真正麻烦的是数量一多，同一频道会反复出现，复制整理也很容易漏掉信息。
我把这套流程做成了一个桌面软件。它先通过 YouTube Data API v3 搜索相关视频和频道，再按国家地区、订阅量等条件筛选，最后把结果写入CSV。如果频道公开了社媒链接或联系信息，还可以选择从About页面补充采集。
参考仓库：github.com/mashukui/youtube_user
这篇文章不讨论泛泛的“红人营销”，主要记录软件为什么这样设计、数据从哪里来，以及实际使用时怎样设置条件更合理。
## 为什么从视频反查频道
YouTube 上的大部分检索行为都围绕视频展开。输入一个产品名、品牌名或行业词后，搜索结果首先返回相关视频，而每条视频都对应一个发布频道。
因此，软件没有直接堆积频道列表，而是采用下面这条路径：
```text
关键词搜索视频
↓
提取视频对应的频道 ID
↓
对重复频道进行合并
↓
批量查询频道资料
↓
按国家地区和订阅量过滤
↓
按需补充公开联系信息
↓
写入 CSV
```
这种方式会保留“这个频道是被哪个关键词、哪条视频找到的”这一层来源信息。后续查看结果时，不只有一个孤立的频道链接，还能回到具体内容判断它是否真的符合目标方向。
## 软件界面与筛选条件
软件使用 Python 和 Tkinter 开发，并打包为 Windows、macOS 可直接运行的桌面程序。日常使用不需要单独安装 Python，主要操作都集中在一个窗口中。
界面里的输入项可以分成三类：
- 搜索关键词决定从什么内容方向寻找频道。
- 国家地区用于缩小目标市场，也可以留空，不限制地区。
- 最小和最大订阅量用于控制频道规模。
此外，页面补抓是可选项。只需要频道基础数据时，可以关闭它，让任务集中在官方 API 阶段。需要整理频道公开的社媒入口和联系信息时，再开启补抓。
## 数据采集分为两个阶段
软件中的数据并非全部来自同一个接口。把采集过程拆成两个阶段，更容易理解结果中哪些字段稳定，哪些字段可能为空。
### 第一阶段：通过官方 API 获取基础数据
第一阶段使用 YouTube Data API v3，主要完成四件事：
1. 按关键词分页搜索视频，每页最多读取 50 条结果。
2. 获取视频详情和播放量等信息。
3. 提取频道 ID，去重后批量查询频道资料。
4. 根据频道公开的国家地区和订阅量执行筛选。
频道名称、频道 ID、订阅量、视频总数、总观看次数和注册日期等字段主要在这个阶段获得。这里需要消耗 Google 分配给 API Key 的调用配额，任务量较大时要留意当天的剩余额度。
### 第二阶段：从公开页面补充信息
YouTube Data API 不会直接提供所有联系信息。开启补抓后，软件会尝试访问频道 About 页面，从公开内容中识别 Telegram、WhatsApp、X、Facebook、Instagram、TikTok 等链接，并补充页面中能够正常读取的邮箱信息。
这个阶段有明确的结果边界。频道没有主动公开、页面暂时无法访问，或者内容需要额外验证时，对应字段都可能为空。因此，补抓只能整理已经公开且当前可访问的信息，不能保证每个频道都有邮箱或社媒链接。
## CSV 中保存了哪些内容
软件当前导出的核心数据较宽，一张截图无法完整展示，下面分成两部分查看。
前半部分主要记录搜索来源和视频数据，包括搜索关键词、页码、视频标题、视频链接、当前视频播放量，以及对应的频道名称、频道链接和频道 ID。
后半部分以频道资料为主，包括：
- 国家地区、订阅量、视频总数、总观看次数和注册日期
- Telegram、WhatsApp、X、Facebook、Instagram、TikTok 等公开链接
- About 页面中能够读取到的公开邮箱信息
完整表格也可以通过在线文档查看：
> https://docs.qq.com/sheet/DVEFhZlFKR1NXVEdN?tab=ht1erv
软件采用逐条写入方式。每获得一条有效结果就追加到 CSV，而不是等整个任务结束后再一次性保存。这样即使中途遇到网络波动、API 配额不足或程序被关闭，已经写入的数据仍然保留。运行日志也会同步保存，方便检查任务执行到哪一步、在哪个请求处出现了问题。
## 使用前先配置 API Key
运行软件前，需要在 Google Cloud 中启用 YouTube Data API v3，并准备自己的 API Key。具体开通步骤可以参考这篇教程：
[手把手教你开通 YouTube 官方 API 接口](https://mp.weixin.qq.com/s/cFQ8GM3EK5B448qLWytsBw)
获得 Key 后，将它填入软件目录中的 `config_pub.json`。
配置文件中还包含 `wait_sec`，用于设置请求间隔，默认值为 1 秒。这个参数可以根据任务情况调整，但它不会改变 Google 为 API Key 设置的官方配额。
API Key 属于敏感凭据，不要把填写后的配置文件上传到 GitHub，也不要将 Key 放进公开文章或截图。发现异常调用时，应及时在 Google Cloud 后台撤销并重新生成。
## 怎样设置关键词和筛选范围
准备好 API Key 后，在界面中填写搜索条件，再启动任务。
### 关键词不要只写大类
`beauty`、`gaming` 这类泛词能找到大量内容，但结果会比较杂。需要寻找某个细分领域时，可以使用产品类型、品牌名、竞品词或具体内容主题，例如 `skincare review`、`portable power station`。
一次任务也可以组合多个方向，但建议先用少量关键词测试结果。如果第一批视频与目标偏差很大，继续增加页数通常只会得到更多无关频道。
### 国家地区字段可能缺失
国家筛选依据的是频道公开资料，并非根据创作者当前 IP 判断。部分频道没有填写地区，这类频道在启用国家限制后可能会被过滤掉。
如果目标是先建立较大的候选库，可以暂时不限制国家，导出后再人工复核。若任务只关注单一市场，则直接填写目标国家，减少后续清理工作。
### 订阅量要结合任务目的
订阅量范围并没有固定答案。建立长尾创作者库时，可以把上限设得低一些；寻找覆盖面较大的频道时，再提高下限。与其套用统一的“达人等级”，不如先看十几条真实结果，再根据频道内容质量调整区间。
关键词负责确定内容方向，国家地区负责限定市场，订阅量负责控制频道规模。三个条件中任何一个收得过窄，都可能让最终数量明显下降。
## 实现中的几个取舍
从开发角度看，这个工具的难点不在 GUI，而在采集流程的组织。
首先是去重。同一个频道可能有多条视频出现在不同关键词、不同页码中。如果每次都重新查询频道详情，不仅 CSV 会产生重复行，还会浪费 API 配额。因此，程序会先收集频道 ID，再合并重复项。
其次是批量请求。频道和视频详情接口都支持一次提交多个 ID。将 ID 分组查询，比逐条请求更节省配额和时间，也能让接口调用结构更清楚。
最后是保存时机。长任务最怕运行到一半才发现前面的数据没有落盘。逐条写入 CSV 会增加少量文件操作，但对桌面采集工具来说，这个代价可以接受，任务中断后的损失也更小。
## 使用时需要注意的边界
官方 API 让基础数据的获取方式更稳定，但不代表任务没有限制。API Key 有配额，频道资料可能不完整，公开页面也会发生变化。实际结果少于预期时，可以依次检查关键词覆盖范围、国家和订阅量条件、Key 的剩余配额，以及 About 页面是否能够正常访问。
采集到的公开联系方式适合用于频道建库、市场调研和后续人工筛选。使用这些数据时，仍需遵守 YouTube API 服务条款、当地数据保护要求和反骚扰规则。软件负责整理数据，是否适合合作还需要结合频道内容、更新频率和真实互动情况进一步判断。
______
本文参考仓库：github.com/mashukui/youtube_user
