Tools Snippet

Search Console API Adds Branded, Multimodal and Multi-Country Filters

Markdown
View as Markdown Open this page as plain text
This page as Markdown, ready to paste into ChatGPT, Claude or a doc.
RSS
On the left, a drawing of a code panel headed POST searchAnalytics/query, showing a JSON request body grouped by country. A filter sets dimension brandedClassification, operator equals, expression NON_BRANDED, and a filterLists entry sets dimension country with the expressions deu, aut and che. The brandedClassification line and the filterLists line are highlighted in yellow. On the right, a yellow Search Console label above the headline The branded filter reaches the API, and the line Plus Lens and Circle to Search data, and several countries in one request.
Non-branded traffic for Germany, Austria and Switzerland in one Search Analytics API request, with the two new fields highlighted.

Google’s Search Console team announced on 16 November 2026 that three features already in the Performance report are now in the Search Analytics API, the interface behind custom dashboards, scripts and third-party tools that pull Search Console data. Until now, API users had to keep their own brand regex lists, could not request multimodal data at all, and needed a separate request per country or device.

What did Google add to the Search Analytics API?

The announcement, from Daniel Waisberg, Nati Yosephian and Karin Gadasi of the Search Console team, lists three options:

  • Branded queries. Group or filter by brandedClassification to compare branded and non-branded performance. As in Search Console, Google says this works only for eligible properties, and “for other properties, the response won’t include any rows.”
  • Web multimodal. Setting type to webMultimodal returns performance data from Google Lens, Circle to Search on Android and image uploads in Google Search. Google says this data will also be available in BigQuery for properties with an active bulk data export.
  • Multi-country and multi-device filters. A new filterLists field filters by several countries or devices in a single request, so a regional total such as DACH or EMEA comes back as one query.

Google says the filters can be combined, for example branded traffic across a group of countries. This request body returns non-branded clicks and impressions for Germany, Austria and Switzerland, one row per country:

{
  "startDate": "2026-10-19",
  "endDate": "2026-11-15",
  "dimensions": ["country"],
  "dimensionFilterGroups": [{
    "filters": [
      { "dimension": "brandedClassification", "operator": "equals", "expression": "NON_BRANDED" }
    ],
    "filterLists": [
      { "dimension": "country", "expressions": ["deu", "aut", "che"] }
    ]
  }]
}

The other branded value is BRANDED, and equals is the only operator the branded filter accepts.

What should you change in API-based reporting?

If a dashboard or script splits branded from non-branded traffic with a regex list, brandedClassification can replace it on a qualifying property, and Google’s classifier recognises brand variations, misspellings and brand-related product names that a hand-built list has to spell out one by one. The branded queries filter is available only on top-level properties with enough query volume. The Search Analytics API reference sets its other limits, and three of them keep the regex in use:

LimitWhat a report should do
A property that is not eligible gets no rowsTreat an empty result as “not available”, not as zero branded clicks, and keep the regex for that property
No branded data before 21 February 2026; a request for earlier dates returned no rows rather than an error when tested on 19 November 2026Use the regex for comparisons reaching further back, such as a year-on-year split around the November 2026 core update
Cannot be combined with a query filter, and the request fails if it isUse the regex to slice branded traffic by query text
One dimension cannot appear in both filters and filterListsPut each dimension in one or the other

Multimodal traffic was missing from API-fed reports when Search Console added it to the Performance report in September, because the API had no type for it. Add a webMultimodal request if image-led searches matter to the site. Regional totals that were built by adding up one request per country, the workaround before Search Console combined several countries in one filter, can now come from a single filterLists call.

Sources

More news