如何通过YouTube Data API v3判断视频是Shorts还是常规视频?
判断YouTube视频是否为Shorts的API方案
仅请求part=snippet无法获取区分Shorts和常规视频的标识,需要请求额外的part字段,以下是两种可靠的判断方式:
1. 通过宽高比+时长判断(推荐)
请求包含contentDetails的接口,获取视频的宽高比和时长信息:
https://www.googleapis.com/youtube/v3/videos?key=[API_KEY]&id=[VIDEO_ID]&part=snippet,contentDetails
- 解析返回结果中的
contentDetails.aspectRatio:如果值为9:16,说明是竖屏视频,这是Shorts的核心特征; - 结合
contentDetails.duration(ISO 8601格式,如PT59S表示59秒):Shorts的时长通常≤60秒,结合宽高比可以大幅提高判断准确率。
注意:少数常规竖屏视频也可能符合9:16+短时长的条件,但这种情况占比极低,足以满足大部分场景需求。
2. 通过标签辅助验证
使用你当前的接口(请求part=snippet),查看snippet.tags字段:
- 如果标签列表中包含
#Shorts或Shorts,则该视频大概率是作为Shorts上传的。 - 缺点:该标签并非强制添加,部分Shorts视频可能没有这个标签,所以只能作为辅助判断依据。
内容的提问来源于stack exchange,提问作者goose
相关产品推荐
相关产品推荐

