给 AI

问答

YouTube 的视频 ID、频道 ID(UC 开头)和 @handle 分别是什么?

简短回答

视频 ID 是 watch?v= 或 youtu.be/ 后面那 11 位码;频道 ID 是以 UC 开头、永不变化的 24 位 ID;@handle 是频道对外的名字,可以改。okdata 的 YouTube 视频详情接口传视频 ID 或任意视频链接,返回的 author.id 是频道 ID,author.username 是 handle,每次 $0.002。

YouTube 的链接里混着三种标识,不同工具要的还不一样。视频 ID 指一个视频;频道 ID 永久指向一个频道;handle 是频道的 @名字,由频道主自己起,也可以改。分清楚它们,就不会把会失效的那个存成主键。

三者对比

视频 ID 频道 ID handle
例子 Xk3_9fQpL2w UCq7mT2vXbN4rLk9sHd0aWzE @trailkitgear
格式 11 个字符,取自 A-Z、a-z、0-9、- 和 _ UC 加 22 个字符,共 24 位 3 到 30 个字符,中间可以有 _、- 和 .
出现在网址里 watch?v=、youtu.be/、/shorts/、/live/ youtube.com/channel/UC… youtube.com/@handle
会不会变 不会 不会 频道主可以改

视频 ID 和频道 ID 用的是 base64 的 URL 安全字母表,所以会出现 - 和 _。/c/名字、/user/名字 这种老链接还在,YouTube 说明新的自定义网址已经不能再设置,这些旧链接现在会跳转到 handle 网址。handle 不区分大小写。

该存哪个

视频按视频 ID 存,频道按频道 ID 存。handle 和频道名称当标签,定期刷新。去年表格里记下的 handle,现在可能已经打不开,或者指向了别的频道。

怎么互相换算

YouTube 视频详情可以传 id,也可以把上面任一种视频链接作为 url 传进去,返回的 author.id 是频道 ID(UC…),author.username 是不带 @ 的 handle。YouTube 视频搜索的每条结果也带着同样的作者字段。接口目录里没有频道类接口,所以从 handle 换到频道 ID,可以走这几条路:

  • 找这个频道的任意一个视频,调视频详情,读 author.id;
  • 按频道名称搜一次,留下 author.username 对得上的结果;
  • 如果你有 Google Cloud 项目和密钥,用 YouTube 官方 Data API 的 channels.list,传 forHandle=@名字 就能拿到频道资源。
要做的事 调用次数 费用
视频链接换成视频 ID、频道 ID 和 handle 1 $0.002
通过一页搜索把 handle 换成频道 ID 1 $0.004
表格里的 200 个视频链接 200 $0.40

示例

curl -G "https://api.okdata.online/v1/youtube/videos/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'url=https://youtu.be/Xk3_9fQpL2w' \
  --data-urlencode 'fields=id,author.id,author.username,author.name'

返回里的 data.item 只剩这几个字段:

{ "id": "Xk3_9fQpL2w",
  "author": { "id": "UCq7mT2vXbN4rLk9sHd0aWzE", "username": "trailkitgear", "name": "Trail Kit" } }

限制

  • 视频 ID 本身不会变,但视频可能被删除或设为私享,这时详情接口返回 not_found,这次调用照常计费。
  • 播放列表 ID(PL…)或频道链接都不是视频链接,视频详情读不了。
  • 非拉丁文字的 handle 规则不一样,YouTube 的 handle 帮助页列出了中文、韩文等文字的长度要求。

拿到 ID 之后想查播放和点赞,见怎么从链接拿到 YouTube 视频的播放量和点赞。

资料来源

  1. YouTube 帮助:了解 YouTube 频道的网址support.google.com · 读取于
  2. YouTube 帮助:了解 YouTube 名称(handle)support.google.com · 读取于
  3. YouTube Data API:Channels list(forHandle 参数)developers.google.com · 读取于
  4. Base64(维基百科):YouTube 使用的 URL 安全字母表en.wikipedia.org · 读取于

这个问题出现过的地方(读取于 2026-11-12)

更新于

接上一次,以后直接问 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