YouTube — 视频详情
SpiderHubs OpenAPI 文档:YouTube — 视频详情,分类 YouTube。接口 GET /openapi/v1/contentcreator/youtube/web_v2/get_video_info_v2。按视频 ID 或视频页链接读取公开详情:标题、简介、频道、发布时间、时长、播放量...
OpId:
yt-video-info · 最近更新: 2026-11-19说明
按视频 ID 或视频页链接读取公开详情:标题、简介、频道、发布时间、时长、播放量、点赞、评论数和封面。返回的是观看页信息,不是可下载的视频文件。video_id 与 video_url 至少传一个;同时传时以 video_id 为准。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/youtube/web_v2/get_video_info_v2
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| video_id | string | 否 | 11 位视频 ID,例如 ZFEnfscZpAU |
| video_url | string | 否 | watch、shorts 或 youtu.be 链接。已传 video_id 时忽略 |
| need_format | boolean | 否 | 是否返回清洗后的字段。默认 true |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码,200 表示成功 |
| request_id | string | 本次请求唯一标识,排查问题时可提供 |
| data | object | 业务数据容器,具体字段见下 |
| data.video_id | string | 视频 ID |
| data.video_url | string | 观看页链接 |
| data.title | string | 标题 |
| data.description | string | 简介 |
| data.author | string | 频道显示名 |
| data.channel_id | string | 频道 ID |
| data.channel_url | string | 频道页链接 |
| data.length_seconds | int | 时长(秒) |
| data.view_count | int | 播放量 |
| data.like_count | int|string | 点赞数。可能带千分位 |
| data.comment_count | int | 评论数 |
| data.thumbnail_url | string | 封面 |
| data.captions | array | 已有字幕的语言列表。要正文请调「自带字幕」 |
请求示例 · cURL
curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/youtube/web_v2/get_video_info_v2?video_id=ZFEnfscZpAU' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "8f0c2a1e-4b7d-4c1a-9e20-0a6c3d91b214",
"data": {
"video_id": "ZFEnfscZpAU",
"video_url": "https://www.youtube.com/watch?v=ZFEnfscZpAU",
"title": "Example title",
"description": "Example description",
"author": "Example channel",
"channel_id": "UCBR8-60-B28hp2BmDPdntcQ",
"channel_url": "https://www.youtube.com/channel/UCBR8-60-B28hp2BmDPdntcQ",
"length_seconds": 42,
"view_count": 1200,
"like_count": 80,
"comment_count": 6,
"thumbnail_url": "https://i.ytimg.com/vi/ZFEnfscZpAU/hqdefault.jpg"
}
}开始调用 SpiderHubs API
使用账户中心生成的 API Key,通过 Authorization: Bearer sk_live_xxx 调用接口。