使用YouTube API v3获取8万视频ID时仅返回19页数据的问题

看起来你碰到了YouTube Data API的一个核心限制——Search.list接口最多只能返回1000条搜索结果，这就是为什么你不管换什么关键词，翻到19页左右（按每页50条算就是950条）就拿不到NextPageToken的原因。官方明确设定了这个上限，不是代码bug，得换思路解决。

为什么会出现这个问题？ #

YouTube的Search.list端点为了防止滥用，对单次搜索的结果数量做了硬限制：最多返回1000条结果。不管你的搜索关键词能匹配多少视频，API都只会返回前1000条。你设置的maxResults如果是50，理论上最多能拿到20页，但实际情况中可能因为重复结果、内容过滤等原因，实际可获取的页数会略少（比如19页），之后nextPageToken就会变成undefined，表示没有更多结果了。

可行的解决方案 #

根据你的需求（获取大量视频ID），这里有几个替代方案：

1. 针对特定频道获取所有视频（如果适用） #

如果你的目标是获取某个或某几个频道的所有视频，别用Search.list，改用更高效的方式：

• 先用Channels.list接口，通过频道ID或用户名获取该频道的uploads播放列表ID（在contentDetails.relatedPlaylists.uploads字段里）。
• 然后用PlaylistItems.list接口遍历这个播放列表，这个接口没有1000条的限制，只要频道有视频，就能一直分页拿到所有结果，而且每次调用只消耗1单位API配额（Search.list每次要100单位，能省大量配额）。

2. 拆分搜索范围（必须用关键词搜索时） #

如果必须通过关键词搜索大量视频，只能拆分搜索条件来绕过1000条的限制：

• 按发布日期拆分：比如把搜索范围分成2020-2021、2021-2022等时间段，给每个搜索请求加上publishedAfter和publishedBefore参数，这样每个时间段的结果可能不会超过1000条，最后把所有结果合并。
• 按视频属性拆分：比如分别搜索videoDuration=short/medium/long，或者加上type=video参数（你当前代码没指定，会返回频道、播放列表等非视频结果，浪费配额和结果名额）。

3. 优化现有代码的分页逻辑 #

你的代码片段里，要确保正确更新next_page并处理无更多结果的情况，优化后的代码示例：

async.eachSeries(check_array, function iterator(value, callback) {
  console.log(next_page);
  var params = {
    q: q,
    part: 'snippet',
    maxResults: max,
    order: 'title',
    type: 'video' // 仅返回视频，避免非目标结果占用名额
  }
  if(next_page){
    params.pageToken = next_page;
  }
  client.search(params, function (err, data) {
    if (err) {
      console.error('API请求错误:', err);
      return callback(err); // 用async回调处理错误，不要直接throw
    }
    // 提取当前页的视频ID
    const videoIds = data.items.map(item => item.id.videoId);
    // 将videoIds保存到你的存储介质中...

    // 更新分页token
    next_page = data.nextPageToken;
    // 没有更多结果时停止迭代
    if (!next_page) {
      return callback('已获取所有可用搜索结果');
    }
    // 继续下一页请求
    callback();
  });
});

额外提醒 #

别忘了YouTube API的配额限制：每天默认配额是10000单位，Search.list每次调用消耗100单位，所以单关键词最多只能调用20次（拿到1000条结果）。如果需要更多配额，可以去Google Cloud控制台申请提升。

内容的提问来源于stack exchange，提问作者Stan Chechun