如何在Google Custom Search API中排除指定URL或站点？

• 优先使用官方专属排除参数
  Google Custom Search API提供了专门的站点过滤参数组合，比在q里写-site语法更可靠，且不受普通搜索的32词限制影响：

  • 设置siteSearch为需要排除的站点域名（比如example1.com）
  • 设置siteSearchFilter为e（代表exclude，即排除该站点）
    示例请求参数：

  q=你的搜索关键词
  siteSearch=example1.com
  siteSearchFilter=e
  

• 批量排除多站点的处理方案
  如果需要排除多个站点，若站点数量少，可以直接在q参数中组合多个-site语法（注意控制q的总词数不超过32）：

  q=你的搜索关键词 -site:example1.com -site:example2.com
  

  若站点数量多导致q超词数，需分多次调用API（每次排除一个站点），再自行聚合返回结果。

• 排查-inurl无效的情况
  -inurl的匹配逻辑是严格匹配URL中完整包含的字符串，比如-inurl:example1.com无法匹配example1.co.uk这类变体域名。确保你使用的是目标站点的准确域名片段，避免因域名格式差异导致过滤失效。

• 避免参数冲突
  不要同时混用多种排除方式（比如同时设置excludeTerms和siteSearch+siteSearchFilter），这会导致API过滤逻辑混乱，建议只保留最可靠的siteSearch+siteSearchFilter组合。

• 验证请求与结果
  在Postman中发送请求后，直接检查返回结果的items字段里的link值，确认是否真的存在被排除的站点。若仍有问题，可尝试调整搜索关键词，排除因关键词与目标站点内容高度关联导致的过滤例外情况。

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