一、接口简介YouTube Data API v3videos.list是官方获取单 / 多条视频完整详情的标准接口。 鉴权方式公开数据使用API Key私有视频、评论、字幕需 OAuth2.0通过id参数传入视频 ID 查询part参数按需指定返回片段snippet/contentDetails/statistics统一返回标准 JSON 结构用于海外短视频数据分析、创作者监控、竞品调研、内容素材采集等场景Google for Developers。二、主流业务实战场景海外博主数据监测定时抓取达人视频播放、点赞、评论数据评估账号流量变现能力竞品海外内容分析提取竞品视频标题、标签、时长、简介拆解爆款选题逻辑品牌海外舆情监控批量检索品牌相关视频统计用户互动与口碑倾向短视频素材聚合工具获取视频多尺寸封面、标题文案用于内容聚合展示行业趋势数据分析按分类统计播放量、互动率输出海外内容行业报表三、标准完整 JSON 返回正常成功示例官方原生结构{ kind: youtube#videoListResponse, etag: \UCBpFjp2h75_b92t44sqraUcyu0/XwZ123abcDEF456\, pageInfo: { totalResults: 1, resultsPerPage: 1 }, items: [ { kind: youtube#video, etag: \UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\, id: 7lCDEYXw3mM, snippet: { publishedAt: 2012-06-20T22:45:24.000Z, channelId: UC_x5XG1OV2P6uZZ5FSM9Ttw, title: Google I/O 101: QA On Using Google APIs, description: Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0., thumbnails: { default: { url: https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg, width: 120, height: 90 }, medium: { url: https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg, width: 320, height: 180 }, high: { url: https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg, width: 480, height: 360 } }, channelTitle: Google Developers, tags: [Google API, OAuth2, Google I/O, 开发教程], categoryId: 28, liveBroadcastContent: none }, contentDetails: { duration: PT1H23M12S, dimension: 2d, definition: hd, caption: true, licensedContent: true }, statistics: { viewCount: 158907, likeCount: 5947, favoriteCount: 0, commentCount: 241 } } ] }四、高频异常错误 JSON 示例1. 每日配额耗尽 403 quotaExceeded{ error: { code: 403, message: The request cannot be completed because you have exceeded your quota., errors: [ { message: The request cannot be completed because you have exceeded your quota., domain: youtube.quota, reason: quotaExceeded } ], status: PERMISSION_DENIED } }2. API Key 无效 / 未开启接口 403 forbidden{ error: { code: 403, message: API key not valid. Please pass a valid API key., errors: [ { message: API key not valid. Please pass a valid API key., domain: usageLimits, reason: keyInvalid } ], status: PERMISSION_DENIED } }3. 视频 ID 不存在 / 视频已下架 404 notFound{ kind: youtube#videoListResponse, etag: \xxx\, pageInfo: { totalResults: 0, resultsPerPage: 0 }, items: [] }4. 请求参数缺失 400 badRequest{ error: { code: 400, message: Missing required parameter: id, errors: [ { message: Missing required parameter: id, domain: global, reason: missingParameter, location: parameter, locationType: query } ], status: INVALID_ARGUMENT } }五、核心字段极简说明1. 顶层公共结构kind资源类型固定youtube#videoListResponseitems视频数据数组单条视频封装为youtube#video对象pageInfo分页统计总数与每页条数2. snippet基础元信息id视频唯一 VID查询主键title/description视频标题、简介文案publishedAtISO 标准 UTC 发布时间channelId/channelTitle创作者频道 ID 与频道名thumbnails多分辨率封面图地址tags视频标签数组用于内容归类分析3. contentDetails视频媒体属性duration时长 ISO 格式PT1H23M12S1 小时 23 分 12 秒definition清晰度 hd/sdcaption是否自带字幕4. statistics互动数据核心viewCount播放总量字符串类型需转数字计算likeCount点赞数commentCount评论总数六、开发使用注意事项part参数按需填写只拉取需要片段减少配额消耗播放、点赞等数值为字符串代码必须转整型避免计算报错接口存在每日配额默认 10000 单位批量采集需做缓存、限流时间字段为 UTC 时区业务展示需手动转换本地时区无权限、下架视频会返回空 items 数组需单独做空数组判断仅可用于合规数据分析禁止批量爬取、商用倒卖平台原始视频数据。