You need to enable JavaScript to run this app. YouTube API单次调用获取频道全部视频maxResults返回数量异常问题
优惠活动
大模型
产品
解决方案
定价
更多

YouTube API单次调用获取频道全部视频maxResults返回数量异常问题

问题成因

YouTube Data API v3 的 search.list 接口对 maxResults 参数存在官方硬上限限制,该参数合法取值范围为0到50,就算传入大于50的数值,接口也会自动将参数值修正为50再返回结果,这就是你设置maxResults=111却只能拿到50条数据的核心原因,该限制无法通过修改单请求参数突破。

解决方法

要获取指定频道的全部公开视频,可选择以下两种方案:

  • 方案一:基于search.list接口分页拉取

    1. 保持现有请求参数,将maxResults调整为最大值50发起第一次请求,拿到第一页50条数据的同时,提取响应体中的nextPageToken字段值
    2. 后续每次请求都在原有参数基础上新增pageToken参数,值为上一次请求返回的nextPageToken,每次请求最多可获取50条数据
    3. 重复发起请求直到响应中不再返回nextPageToken,即已拉完该频道所有公开视频

    注意:search.list接口单请求会消耗100单位API配额,若频道视频量较大,配额消耗会很高,更推荐使用方案二。

  • 方案二:使用playlistItems.list接口拉取(更推荐)
    该方案配额消耗极低,单请求仅消耗1单位配额,操作步骤如下:

    1. 先调用channels.list接口,请求参数设置为part=contentDetails&id={目标频道ID},从返回结果的contentDetails.relatedPlaylists.uploads字段,获取该频道的上传视频专属播放列表ID
    2. 再调用playlistItems.list接口,请求参数设置为part=snippet,contentDetails&playlistId={刚获取的上传列表ID}&maxResults=50,同样通过nextPageToken分页拉取,直到无nextPageToken返回即可拿到全量视频数据,整体效率远高于search.list方案。

内容的提问来源于stack exchange,提问作者Kamarat AbdelSalam

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 11:06:04