问答
怎么用 API 查 YouTube 频道的订阅数和频道数据?
简短回答
用 YouTube 频道资料接口,传 @用户名或 UC 开头的频道 ID,返回按 YouTube 页面显示的订阅数和视频数;加上 view=full,还有频道总播放量、注册日期、国家和“关于”里的链接,每个频道 $0.002。不需要 Google Cloud 项目和 API key。已经有项目的话,Data API 的 channels.list 每次 1 个配额单位就能拿到同样的统计,其中 subscriberCount 向下取整到三位有效数字。
一个做游戏外设的品牌,赞助备选名单里有 60 个 YouTube 频道。团队每个月要更新一次每个频道的订阅数、总播放量、注册时间和国家,还要看最近几期视频的播放,因为老频道的订阅数往往比现在真正在看的人多得多。他们手上只有从频道链接里复制的 @用户名,没有频道 ID。
频道资料:一个频道一次调用
YouTube 频道资料传 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 频道视频按从新到旧列出频道上传的视频,每页约 30 条,有标题、播放数、封面、时长和大概的发布时间(YouTube 只显示“3 周前”这种)。加 type=short 换成频道的 Shorts。拿最近 30 条视频播放数的中位数,比订阅数更能说明一个频道现在的影响力。
找还不认识的频道
YouTube 频道搜索传关键词,每页返回 20 个频道,有频道 ID、名称、简介开头、头像和订阅数,每页 $0.004。搜索结果里没有用户名和认证标识,要看认证和总播放量,把频道 ID 传给频道资料接口。
用 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 视频详情,每条 $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 服务和 TikTok、X 的数据一起查,用 okdata 更合适。单条视频的播放量,见 YouTube 播放量查询。
资料来源
这个问题出现过的地方(读取于 2026-11-15)
更新于