---
title: "Search Console API Adds Branded, Multimodal and Multi-Country Filters"
description: "Google's Search Analytics API now returns branded classification, multimodal search data and several countries or devices in one request."
tldr: "The Search Analytics API, which scripts, dashboards and third-party tools use to pull Search Console data, gained three Performance report features on 16 November 2026: the branded queries classification, multimodal search data from Lens, Circle to Search and image uploads, and filters for several countries or devices in one request. Branded data starts on 21 February 2026. Properties not eligible for the branded filter get no rows back, which a script can mistake for zero branded traffic."
publishDate: 2026-11-19
author: "Liam Hayward"
---
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:

```json
{
  "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](/seo-analytics/branded-vs-non-branded/) is available only on top-level properties with enough query volume. The [Search Analytics API reference](https://developers.google.com/webmaster-tools/v1/searchanalytics/query) sets its other limits, and three of them keep the regex in use:

| Limit | What a report should do |
|---|---|
| A property that is not eligible gets no rows | Treat 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 2026 | Use the regex for comparisons reaching further back, such as a year-on-year split around the [November 2026 core update](/seo-news-updates/google-november-2026-core-update/) |
| Cannot be combined with a `query` filter, and the request fails if it is | Use the regex to slice branded traffic by query text |
| One dimension cannot appear in both `filters` and `filterLists` | Put each dimension in one or the other |

Multimodal traffic was missing from API-fed reports when Search Console [added it to the Performance report](/seo-news-updates/google-search-console-multimodal-search-reporting/) 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](/seo-news-updates/search-console-combined-country-filter/), can now come from a single `filterLists` call.

## Sources

- [New filtering and reporting capabilities in the Search Analytics API, Google Search Central Blog](https://developers.google.com/search/blog/2026/11/search-analytics-api-update), 16 November 2026
- [Search Analytics: query, Search Console API reference](https://developers.google.com/webmaster-tools/v1/searchanalytics/query)
- [Introducing the branded queries filter in Search Console, Google Search Central Blog](https://developers.google.com/search/blog/2025/11/search-console-branded-filter)