Google Search Console API 支持品牌词拆分与多模态搜索数据
Branded Query Data Is Now In The Google Search Console API via @sejournal, @MattGSouthern
Google 在 Search Console 的 Search Analytics API 中新增三项功能,正式支持品牌与非品牌查询过滤、多模态网页搜索数据以及单次请求筛选多地区或设备。
同一件事,精选收录的是《Google 为 Search Analytics API 推出品牌词、多模态与多维度筛选功能》
Google 宣布,已将 Search Console“效果”报告中的三项功能接入 Search Analytics API。这意味着网站开发者和工具开发商可以直接把这些功能整合进自己的自动化报告系统中。
Google 在相关的博文中指出,该 API 现已支持品牌词过滤、多模态网页搜索数据(web multimodal),并支持在单次 API 请求中同时追踪多个国家或设备类型。
博文提到,这三项功能自推出起就一直在“效果”报告中提供。文章表示,此次推出 API 版本后,开发者便无需再“费力拼接多次独立的请求,或是维护复杂的关键词正则表达式列表”。
品牌词数据起始日期:2026 年 2 月 21 日
API 返回的结果现已支持 brandedClassification 维度,用户可根据品牌搜索与非品牌搜索使用 BRANDED 或 NON_BRANDED 进行筛选或分组。根据 API 参考文档,该新维度仅针对顶级资源提供数据,起始时间为 2026 年 2 月 21 日;不过博文同时指出,如果资源的查询次数和展示次数未达到门槛,将返回空表(无数据行)。
API 参考文档还注明,品牌分类维度字段仅支持 equals 运算符,且若请求中已应用了查询过滤条件,则无法再使用该维度进行筛选或分组。
Google 此前的公告展示了“效果”报告中的品牌与非品牌选项:

今年 3 月,有 Search Console 用户发帖反映,其品牌词细分数据最早只能追溯到 2 月 21 日前后,并询问能否将更早的数据也按这两类拆分。据 Roger Montti 报道,Google 的 John Mueller 对此回应称,“数据追踪确实存在一个起始节点”。
多模态数据获得独立的 API 类型
文档显示,当 type 设为 webMultimodal 时,系统会提供多模态效果指标,涵盖使用 Google Lens 搜索、在 Android 设备上使用 Circle to Search(即圈即搜),以及在 Google 搜索中上传图片等场景。
Search Console 在 9 月 24 日上线多模态报告后,我曾报道过 API 参考文档中尚未列出独立的多模态类型值。而文档在 11 月 16 日更新后,现已正式加入该项。
Google 在 9 月的公告中展示了报告“搜索类型”过滤器里的多模态选项:

Google 的 9 月公告中还提到了 Chrome 右键“搜索此图片”功能,“效果”报告的帮助页面也包含了 Chrome 图片搜索。不过,此次的 API 博文和参考文档均未提及 Chrome。
11 月 16 日的博文表示,多模态数据“未来也将面向启用了批量数据导出功能的资源开放至 BigQuery”,但并未给出具体日期。截至 11 月 16 日,批量导出数据表参考文档中列出了六种搜索类型,目前尚不包含多模态类型值。
单次请求即可查询多个国家或设备
全新加入的 filterLists 字段允许用户在单次请求中同时按多个国家或多种设备过滤结果。博文中给出的示例包括按国家组合的区域分组,如 EMEA、LATAM 或 DACH。
API 参考文档将 filterLists 限制在国家/地区和设备维度,且仅支持精确值匹配。在同一次请求中,用户不能在 filters 和 filterLists 中使用同一个维度(国家/地区或设备)。
核心看点
自 2026 年 2 月 21 日起,在符合条件的资源中,使用该 API 的团队可以通过这项新功能,在其报表工具中获取品牌词与非品牌词的流量细分。至于该日期之前的数据,API 则无法拆分品牌与非品牌搜索流量。
Google 借助 AI 辅助流程来判断搜索属于品牌词还是非品牌词。正如 Google 在 2025 年 11 月的公告中所说,“部分查询偶尔可能会被误判”。如需找出差异,可以将 API 划分的品牌/非品牌数据与现有的品牌正则表达式比对,查看二者的出入之处。
截至 11 月 16 日,API 参考文档尚未说明 web 结果是否包含 webMultimodal 数据。在将 web 和 webMultimodal 的总数相加之前,请先核对 API 的 web 数据与“效果”报告中的文本及多模态数据是否一致。
未来展望
截至 11 月 16 日,Google 的官方发文和 API 参考文档均未说明 webMultimodal 数据最早可追溯到何时。建议查阅 API 参考文档和批量导出表参考文档,留意 BigQuery 日期、多模态历史数据的起始时间,以及是否有关于 Chrome 图片搜索的说明。
题图来源:aileenchik/Shutterstock
来源:Search Engine Journal · searchenginejournal.com