# 怎么用 API 查 YouTube 频道的订阅数和频道数据？

> 按 @用户名或频道 ID 查 YouTube 频道的订阅数、视频数、总播放量、注册日期和国家，再看最近视频的播放。价格、Python 代码，以及官方 Data API 的配额怎么算。

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

**简短回答：**用 YouTube 频道资料接口，传 @用户名或 UC 开头的频道 ID，返回按 YouTube 页面显示的订阅数和视频数；加上 view=full，还有频道总播放量、注册日期、国家和“关于”里的链接，每个频道 $0.002。不需要 Google Cloud 项目和 API key。已经有项目的话，Data API 的 channels.list 每次 1 个配额单位就能拿到同样的统计，其中 subscriberCount 向下取整到三位有效数字。

一个做游戏外设的品牌，赞助备选名单里有 60 个 YouTube 频道。团队每个月要更新一次每个频道的订阅数、总播放量、注册时间和国家，还要看最近几期视频的播放，因为老频道的订阅数往往比现在真正在看的人多得多。他们手上只有从频道链接里复制的 @用户名，没有频道 ID。

## 频道资料：一个频道一次调用

[YouTube 频道资料](/zh/apis/youtube/channels/get/)传 `username`（@ 后面那段，带不带 @ 都行）或 `id`（UC 开头的 24 位频道 ID）。

| 字段 | 含义 |
|---|---|
| `followers` | 订阅数，和频道页上显示的一致 |
| `posts` | 视频数，和频道页上显示的一致 |
| `name`、`bio`、`avatar_url`、`verified`、`url` | 名称、简介、头像、认证、频道链接 |
| `ext.views` | 频道总播放量 |
| `ext.created_at` | 频道注册日期 |
| `ext.country`、`ext.links`、`ext.banner_url` | 国家、“关于”里列的链接、横幅图 |

`ext` 里的字段要加 `view=full` 才返回。YouTube 页面上这两个数都是取整显示的（比如 1510 万订阅、1200 个视频），所以 `followers` 返回的是 15100000 这样的数。精确的数字不对外公开。

## 最近的播放：取一页视频列表

[YouTube 频道视频](/zh/apis/youtube/channels/videos/list/)按从新到旧列出频道上传的视频，每页约 30 条，有标题、播放数、封面、时长和大概的发布时间（YouTube 只显示“3 周前”这种）。加 `type=short` 换成频道的 Shorts。拿最近 30 条视频播放数的中位数，比订阅数更能说明一个频道现在的影响力。

## 找还不认识的频道

[YouTube 频道搜索](/zh/apis/youtube/channels/search/)传关键词，每页返回 20 个频道，有频道 ID、名称、简介开头、头像和订阅数，每页 $0.004。搜索结果里没有用户名和认证标识，要看认证和总播放量，把频道 ID 传给频道资料接口。

## 用 Python 做月度表

```python
import csv, datetime, 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["data"]

today = datetime.date.today().isoformat()
with open("channels.csv", "a", newline="", encoding="utf-8") as f:
    w = csv.writer(f)
    for handle in ["mkbhd", "LinusTechTips", "veritasium"]:
        ch = get("/v1/youtube/channels/get", username=handle, view="full")["item"]
        vids = get("/v1/youtube/channels/videos/list", id=ch["id"])["items"]
        views = [v["metrics"]["views"] for v in vids if v["metrics"]["views"] is not None]
        w.writerow([today, handle, ch["id"], ch["followers"], ch["posts"], ch["ext"]["views"],
                    ch["ext"]["created_at"], ch["ext"]["country"],
                    int(statistics.median(views)) if views else ""])
```

## 费用

| 任务 | 调用次数 | 费用 |
|---|---|---|
| 查一个频道 | 1 | $0.002 |
| 60 个频道，各查资料和一页视频 | 60 + 60 | $0.24 |
| 按关键词找 100 个频道 | 5 | $0.02 |
| 1,000 个频道的资料 | 1000 | $2.00 |

请求到了数据源的调用，失败也照常计费。用户名或频道 ID 不存在时，频道资料接口返回 `not_found`，同样计一次费。视频列表分不清频道不存在还是频道没视频，两种情况都按一页收费，所以脚本先查资料，确认频道存在，再用返回的 `id` 去取视频。

## 局限

- 数字按 YouTube 的方式取整。频道隐藏了订阅数的，就没有公开的数字，比较频道前先判断 `followers` 是不是 null。
- 视频列表里的发布时间是估算的，因为 YouTube 只显示“3 周前”。要某条视频的准确日期和点赞数，用 [YouTube 视频详情](/zh/apis/youtube/videos/get/)，每条 $0.002。
- 视频列表只有从新到旧一种排序，不能按播放量排。
- 没有历史数据。像脚本那样每月存一行带日期的记录，才能画出增长曲线。

## 官方 YouTube Data API

有 Google Cloud 项目的话，`channels.list` 带 `part=statistics` 会返回 `subscriberCount`、`viewCount` 和 `videoCount`，一次请求可以传逗号分隔的多个频道 ID，也可以用 `forHandle` 传用户名，每次 1 个配额单位。默认每天 10,000 个单位，名单固定、频道都认识的话，它最便宜，就用它。Google 文档写明 `subscriberCount` 向下取整到三位有效数字，`videoCount` 只算公开视频。配额紧的是找频道这一步：默认额度里 `search.list` 每天只有 100 次。不想维护项目和密钥、每天都要搜新频道，或者想让智能体通过 [MCP 服务](/zh/mcp/)和 TikTok、X 的数据一起查，用 okdata 更合适。单条视频的播放量，见 [YouTube 播放量查询](/zh/answers/youtube-view-count-api/)。

## 用到的接口

- [YouTube 频道资料](https://okdata.online/zh/apis/youtube/channels/get/) `youtube.channels.get`：$0.002/次
- [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/search/) `youtube.channels.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-search-api/)
- [几百个 YouTube 视频的字幕怎么批量下载？](https://okdata.online/zh/answers/bulk-youtube-transcripts/)
- [跑一个社媒数据任务之前，怎么提前知道要花多少钱？](https://okdata.online/zh/answers/estimate-data-api-cost-before-running/)
- [怎么把 YouTube 视频评论导出成 CSV 或 Excel？](https://okdata.online/zh/answers/export-youtube-comments-csv/)
- [抓取社交媒体上的公开数据合法吗？](https://okdata.online/zh/answers/is-scraping-public-social-media-data-legal/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)

## 资料来源

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

- https://stackoverflow.com/questions/30723866
- https://stackoverflow.com/questions/69998628
- https://stackoverflow.com/questions/71271171

更新于 2026-11-15
