Google自定义搜索：脚本调用与设置界面搜索结果为何不一致？

以下是几种可能导致差异的核心原因：

• 参数配置不匹配
  手动搜索时，Google会默认应用一些隐性过滤规则（比如基于搜索习惯的个性化调整），而API调用是无状态的，完全依赖你传入的参数。比如你代码里指定了imgType=photo、fileType=jpg，但手动搜索时可能没有严格应用这些过滤；或者你在调优界面设置了站点优先级、排除规则，但API使用的cx对应的配置未同步生效。

• 日期范围参数格式错误
  代码中sort=date:r:{startDate}:{endDate}的日期格式必须严格遵循YYYY-MM-DD规范，如果你的startDate或endDate是其他格式（比如DD/MM/YYYY），会导致日期过滤失效，返回大量不符合时间范围的无关结果，而手动搜索的日期范围设置是正确的。

• 查询词编码问题
  如果query包含特殊字符（空格、中文、标点），直接拼接进URL会导致编码错误，实际发送给API的查询词和你手动输入的不一致。比如手动输入的“风景照片”，未做URL编码的话可能被解析成两个独立关键词，导致结果偏差。

• 分页逻辑差异
  API的start参数指定结果起始位置，但Google的搜索结果池可能会针对API和手动搜索做区分，比如手动搜索的第2页结果和API中start=11的结果并非完全对应，分页越深差异越明显。

• 安全搜索等级差异
  虽然代码里设置了safe=active，但手动搜索的安全过滤等级可能和API的active级别不同，比如手动搜索启用了更严格的过滤，而API的active只是基础过滤，导致部分无关内容漏过。

验证建议 #

• 把API请求的完整URL复制到浏览器直接访问，对比返回结果和手动搜索的差异，判断是参数问题还是结果池差异。
• 检查cx对应的自定义搜索引擎配置，确保调优界面的所有过滤规则（站点排除、优先级）已保存生效。
• 对query参数做URL编码，比如用urllib.parse.quote(query)处理后再拼接进URL。
• 核对日期格式，确保startDate和endDate是YYYY-MM-DD格式。

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