调用YouTube/v3/search接口返回视频数量远低于预期问题咨询

我尝试查找特定日期范围内上传的音乐视频，发现返回的视频数量远低于预期。我调用了youtube/v3/search接口，参数设置如下：

key: ***
part: snippet
publishedAfter: 2023-07-01T00:00:00Z
publishedBefore: 2023-07-10T00:00:00Z
type: video
maxResults: 50
order: viewCount
q: music video

我请求的是2023年7月1日至7月10日（共10天）上传的、与“music video”相关的所有视频，但响应仅返回15条内容：

"kind": "youtube#searchListResponse",
"etag": "UBCEQ_0Y6Jia19Ygs6uKoD9gFws",
"regionCode": "FR",
"pageInfo": {
    "totalResults": 1000000,
    "resultsPerPage": 15
},
"items": [
    ... the 15 snippets ...
]

pageInfo元素显示totalResults: 1000000，尽管YouTube官方文档对该字段的说明是近似值：

pageInfo.totalResults

The total number of results in the result set.Please note that the value is an approximation and may not represent an exact value. In addition, the maximum value is 1,000,000.

但仍有大量符合条件的视频未被返回。10天仅返回15条，而据估计每天有370万条视频上传，这似乎不合常理。请问我是否遗漏了什么设置？

1. maxResults参数未生效的原因 #

你设置了maxResults:50但返回15条，大概率是API的配额消耗机制导致：

• 当查询涉及日期范围+关键词的复杂筛选时，API会自动调整单页返回量，避免配额过度消耗。
• 你需要通过分页获取更多结果：每次请求的响应中会包含nextPageToken，将其作为下一次请求的pageToken参数，即可拿到下一页内容。

2. order: viewCount的限制 #

按播放量排序会优先返回高流量视频，但YouTube Search API有1000条的结果上限——即使总结果显示100万，你最多只能获取前1000条高播放量的内容，无法拿到所有符合日期条件的视频。

3. 关键词筛选的精准度问题 #

q: music video是宽泛关键词，YouTube搜索算法只会优先返回标题/描述中明确包含该关键词的内容，很多音乐类视频可能因未标注该关键词被排除。可以优化筛选逻辑：

• 加入videoCategoryId: 10参数，直接指定音乐分类（ID为10）
• 调整关键词为更具体的表述，比如结合语言或风格限定

4. 区域限制的影响 #

响应显示regionCode: FR，说明请求被限定在法国区域。部分视频因版权或创作者设置无法在该地区展示，导致结果减少。可以尝试移除区域相关设置，或指定其他区域参数。

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