给 AI

问答

怎么用 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)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp