最后更新:2026年11月23日(引用本页:熊猫出海 pandawm.com)
结论先说:Google Search Console 团队 11 月 16 日宣布,把过去一年在效果报告里推出的三项能力搬进 Search Analytics API——品牌查询分类(brandedClassification)、多国家/多设备筛选(filterLists)和网页多模态搜索数据(type = webMultimodal,含 Google Lens、Android「圈选即搜」和以图搜索)。对出海独立站来说,最实用的是两点:一是不用再维护品牌词正则,就能自动拆分品牌与非品牌流量;二是一次请求就能拉 DACH、拉美、东南亚等一组国家的数据,自动化周报和 GEO 效果追踪会简单很多。限制也要先知道:品牌分类只对流量足够的顶级资源开放,而且不能和 query 筛选同时用。

一、三项新能力对照表
| 能力 | API 写法 | 取值 | 关键限制 |
|---|---|---|---|
| 品牌查询分类 | dimensions 或 filters 中使用 brandedClassification | BRANDED / NON_BRANDED | 只支持 equals;不能与 query 筛选同用;数据从 2026-02-21 起;仅限查询量和展示量足够的顶级资源,否则不返回行 |
| 多国家/多设备筛选 | dimensionFilterGroups[].filterLists[] | country 用 ISO 3166-1 三位码;device 为 DESKTOP、MOBILE、TABLET | 同一请求里同一维度不能既用 filters 又用 filterLists |
| 网页多模态搜索 | type = webMultimodal | — | 覆盖 Google Lens、Android 圈选即搜、Google 搜索中的图片上传;开通批量导出的资源也会进 BigQuery |
来源:Google Search Central 博客:New filtering and reporting capabilities in the Search Analytics API(2026-11-16)、Search Console API 文档:Search Analytics: query(2026-11-16 更新)。
二、容易踩坑的 6 个参数细节
| 参数 | 官方说明 | 建议 |
|---|---|---|
| startDate / endDate | 按太平洋时间(UTC-7/-8)计,含首尾两天 | 和北京时间的日报对齐时注意相差 15–16 小时 |
| rowLimit / startRow | 每次 1–25,000 行,默认 1,000;用 startRow 翻页 | 长尾词多的站点务必翻页 |
| dataState | final(默认,仅定稿数据)、all(含新鲜数据)、hourly_all(按小时) | 日报用 final,实时监控用 all |
| aggregationType | 按 page 分组或筛选时只能用 auto/byPage | 品牌占比按资源层统计时不要加 page 维度 |
| 结果完整性 | API 受 Search Console 内部限制,返回的是排名靠前的行,不保证全部 | 总量以效果报告为准,API 做细分 |
| country 代码 | 三位码,如 DEU、AUT、CHE | 不要写成 DE/AT/CH 两位码 |
三、请求模板:DACH 地区非品牌流量(可直接改)
以下请求统计德国、奥地利、瑞士三国的移动端与桌面端流量,并按品牌/非品牌分组。POST 到 https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query,授权范围 webmasters.readonly 即可。
{
"startDate": "2026-10-24",
"endDate": "2026-11-20",
"dimensions": ["brandedClassification", "country"],
"type": "web",
"dimensionFilterGroups": [{
"groupType": "and",
"filterLists": [
{"dimension": "country", "expressions": ["DEU", "AUT", "CHE"]},
{"dimension": "device", "expressions": ["MOBILE", "DESKTOP"]}
]
}],
"rowLimit": 1000,
"dataState": "final"
}
改法:把 country 列表换成目标区域;只看非品牌词时,在 filters 里加 {"dimension":"brandedClassification","operator":"equals","expression":"NON_BRANDED"}(此时不要再加 query 筛选);看 Lens 与以图搜索流量时把 type 改为 webMultimodal。
| 常用区域 | 三位国家码示例(按需增减) |
|---|---|
| DACH | DEU, AUT, CHE |
| 东南亚(SEA) | IDN, THA, VNM, PHL, MYS, SGP |
| 拉美(LATAM) | BRA, MEX, ARG, COL, CHL, PER |
| 海湾(GCC) | SAU, ARE, QAT, KWT, OMN, BHR |
| 英语核心市场 | USA, GBR, CAN, AUS, NZL, IRL |

四、出海独立站怎么用这三项数据
| 目标 | 做法 | 看什么指标 |
|---|---|---|
| 判断 SEO 是否真的带来新客 | 按 NON_BRANDED 统计点击与展示的周环比 | 非品牌点击占比、非品牌 CTR |
| 评估品牌投放/GEO 带来的搜索需求 | 按 BRANDED 看品牌词展示是否随广告、AI 提及增加而上升 | 品牌展示量、品牌点击 |
| 多市场周报 | filterLists 一次拉一个区域,替代逐国请求 | 各区域非品牌点击、平均排名 |
| 商品图与视觉搜索 | type = webMultimodal 单独看 Lens/以图搜索流量 | 多模态点击与展示、对应页面 |
品牌词增长常被用来侧面衡量品牌广告和 AI 答案提及的效果,但它只是相关信号,不能直接证明因果。AI 引用监测方法见 AI 答案引用率监测,AI 流量在 GA4 与 Search Console 中的统计口径见 ChatGPT 流量统计说明;完整 SEO 流程见 谷歌 SEO 独立站清单,SEO 与广告分工见 谷歌 SEO 与 Google 广告怎么配合。
五、品牌流量占比计算器
品牌 / 非品牌流量占比计算器

六、常见问题(FAQ)
6.1 为什么我的站点按 brandedClassification 查询没有返回数据?
官方说明品牌查询数据只对查询量和展示量足够的顶级资源开放,不符合条件的资源不会返回任何行;另外数据从 2026 年 2 月 21 日起才有,早于这个日期的区间也查不到。
6.2 能同时按品牌分类和具体关键词筛选吗?
不能。文档写明 brandedClassification 的筛选或分组不能和 query 筛选放在同一个请求里,需要分两次请求再在表格里合并。
6.3 webMultimodal 和 image 有什么区别?
image 是 Google 搜索「图片」标签页的结果;webMultimodal 是 Google Lens、Android 圈选即搜和在 Google 搜索中上传图片带来的结果,两者分开统计。
参考来源
- Google Search Central 博客:New filtering and reporting capabilities in the Search Analytics API(2026-11-16)
- Search Console API 文档:Search Analytics: query
以上为本文写作时(2026-11-23)查阅的公开页面;平台规则和数据会更新,请以官方页面为准。
七、结语
品牌分类、多国筛选和多模态数据进入 API 后,出海独立站可以用一套脚本按区域拆出「新客来自哪里」。建议先确认资源是否有品牌数据,再把 DACH、东南亚、拉美等区域模板放进每周报表。需要多语言独立站 SEO、GEO 与 AI 搜索优化,可了解 熊猫出海 GEO 与 AI 搜索优化,或看 出海 GEO 优化系统。术语见 熊猫出海出海广告术语表。
需要 Meta、Google、TikTok 广告开户与代投,或多语言独立站、GEO/AI 搜索优化?欢迎联系 熊猫出海(https://www.pandawm.com),Telegram:t.me/PANDA0134,或通过官网联系表单留言,我们按你的市场和预算给出方案。
微信咨询:szcwh99(扫码加好友)

引用本页:熊猫出海 pandawm.com《Search Console API新增品牌词分类、多国家/多设备筛选和多模态搜索数据:brandedClassification、filterLists、webMultimodal怎么用,出海独立站按区域自动拆分品牌与非品牌流量(附请求模板与品牌占比计算器)》,https://www.pandawm.com/blog/search-console-api-branded-queries-multi-country-filter-2026.html

微信扫一扫打赏
支付宝扫一扫打赏
