YouTube 视频 API
按 URL 或 ID 获取视频或 Short 的完整元数据：标题、简介、频道、观看数和点赞数以及发布日期。
US$0.80/千次请求，按请求付费，无需订阅。
Official Video
Rick Astley
1.5B views · Oct 25, 2009
The official video.
{"id": "dQw4w9WgXcQ","title": "Official Video","channel": "Rick Astley","durationMs": 213000,"views": 1540000000,"likes": 17200000,"createdUtc": 1256453853,"description": "The official video.",... 还有 7 个字段}
价格与服务商
YouTube 视频 API 价格：一个 API，3 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 YouTube 视频
这个示例展示了 18 个字段中的 10 个。查看全部字段
{
"found": true,
"data": {
"id": "dQw4w9WgXcQ",
"title": "Official Video",
"channel": "Rick Astley",
"durationMs": 213000,
"views": 1540000000,
"likes": 17200000,
"createdUtc": 1256453853,
"description": "The official video."
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- idstring
YouTube 视频 ID。Short 与其他视频一样使用视频 ID。
- requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `authorAvatarUrl`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个视频确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。只返回某个字段的四舍五入值或缩写值的数据源，不算返回了该字段。
- urlstring
https://www.youtube.com/watch?v=dQw4w9WgXcQ
完整的 YouTube 视频 URL。Shorts（youtube.com/shorts/...）、youtu.be、直播和嵌入 URL 都支持。
响应
JSON，每个字段一个示例值。
The video result, or null when not found.
- authorAvatarUrlstring可设为必填
URL of the publishing channel's avatar image.
- authorIdstring
YouTube channel ID of the publishing channel.
- authorUrlstring
Canonical URL of the publishing channel, tracking query parameters stripped.
- categorystring
YouTube category the video is filed under, for example "Music".
- channelstring
Rick Astley
Name of the channel that published the video. Populated whenever the provider has data for the entity.
- commentsinteger可设为必填
Number of comments. Some sources round large counts (2.4M instead of 2,457,538); name `comments` in requireFields to be served only by a source that returns the exact count.
- createdUtcnumber
1256453853
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- descriptionstring可设为必填
The official video.
Video description text. Some sources return it as YouTube displays it, with long links shortened (https://colab.research.google.com/dri...) and YouTube or social links replaced by their titles; name `description` in requireFields to be served only by a source that returns every link intact.
- durationMsinteger
213000
Duration of the video in milliseconds.
- idstring
dQw4w9WgXcQ
Unique identifier of the video. Populated whenever the provider has data for the entity.
- imagestring
URL of the video thumbnail image.
- keywordsstring[]
Keywords the uploader tagged the video with.
- likesinteger
17200000
Number of likes.
- titlestring
Official Video
Title of the video. Populated whenever the provider has data for the entity.
- viewsinteger
1540000000
Number of views.
- foundboolean
true
Whether the video was found.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
你在出售这个 API？查看你的接口必须返回的完整数据结构。
常见问题
关于 YouTube 视频 API
AnyAPI 的 YouTube 视频 API 只需一次 POST 请求 /v1/run/youtube.video，就以统一格式的 JSON 返回 YouTube 数据。按 URL 或 ID 获取视频或 Short 的完整元数据：标题、简介、频道、观看数和点赞数以及发布日期。AnyAPI 会在 3 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.80 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 YouTube 视频 API 调用中有 99.8% 成功，响应时间中位数为 2.1 秒，共测量 56,887 次调用。