关于YouTube Search List API的关键词搜索机制及版本差异问询

1. 搜索结果返回规则 #

YouTube的/search/list API不会返回所有匹配搜索条件的条目，而是基于平台搜索算法返回经过筛选、排序后的结果集，本质属于抽样精选返回：

• 单请求受maxResults参数限制（最多返回50条结果），且分页存在上限，通常最多能获取约1000条结果，超过后无法通过pageToken继续翻页
• 结果优先展示算法判定的高相关度、高用户互动内容，并非全量匹配条目

2. API版本间的机制差异 #

目前公开可用的YouTube Data API仅存在v3版本，无广泛使用的更早稳定公开版本，因此不存在不同API版本间的返回机制差异，/search/list的搜索逻辑在v3版本内保持一致。

与Twitter API的对比参考 #

Twitter旧版搜索API（v1.1）明确标注仅返回抽样结果且有严格数量限制；YouTube Search API虽未在文档中直白标注“抽样”，但实际返回逻辑类似——均无法获取全量匹配内容，仅能拿到平台算法筛选后的有限结果集。

内容的提问来源于stack exchange，提问作者César Augusto