Marketing & Sales News

Google expands the Search Analytics API with brand filters and Lens data

261117 search analytics api brand filter cover image
Skip to table of contents
Contents 4 sections
  1. What's new in the Search Analytics API?
  2. What limits apply to the new parameters?
  3. What this means for you
  4. Sources

Google's Search Console team brought three features from the performance report into the Search Analytics API on November 16, 2026: the brand filter, data on multimodal web search, and filters for multiple countries or devices in a single query. Google cites custom analyses and automated workflows as the reason.

In the browser, Search Console already shows all three analyses. What's new is that scripts, dashboards, and reporting tools can now retrieve them as well. Agencies in particular, with reports for many clients, save manual work as a result.

What's new in the Search Analytics API?

The new features appear as three parameters in the query. The brand filter is called brandedClassification and separates queries with a brand reference from all others. The type webMultimodal delivers performance data from Google Lens, from Circle to Search on Android, and from image uploads in Google Search. With filterLists, you specify multiple countries or devices in a single query.

Three new parameters
Search Analytics API according to Google, as of November 16, 2026
ParameterWhat it delivers
  • brandedClassificationQueries with a brand reference and all others
  • type webMultimodalData from Google Lens, Circle to Search, and image uploads
  • filterListsMultiple countries or devices in a single query
All three features are already available in the Search Console performance report
Sources: Google Search Central

The features themselves are not new. According to Search Central, Google announced the brand filter for the performance report on November 20, 2025, and since an update on March 11, 2026, it has been open to all eligible websites. Multimodal web search has been available worldwide in the report since September 24, 2026. For Germany, Google names no restriction for any of the three features.

What limits apply to the new parameters?

The API documentation sets out values and limits:

  • Brand filter: brandedClassification accepts only the operator equals with the values BRANDED and NON_BRANDED. A query filter in the same request is not allowed, and data is only available from February 21, 2026.
  • Eligible properties: Only top-level properties with enough queries and impressions get the brand filter. Properties for a URL path or a subdomain are excluded; for all others, the response contains no rows.
  • Multimodal web search: The type webMultimodal only returns values if your website actually receives visits from such searches. With Bulk Data Export enabled, the data is additionally available in BigQuery.
  • Countries and devices: filterLists sits in dimensionFilterGroups alongside filters and accepts countries as three-letter ISO codes such as DEU, AUT, and CHE, or devices as DESKTOP, MOBILE, and TABLET. Multiple values are treated as an OR combination, and the same dimension must not appear in both filters and filterLists at the same time.

According to Google, an AI-based system handles the brand classification. The system recognizes brand names in all languages, even with typos, as well as queries about the website's unique products or services without the brand name. Individual queries may be classified incorrectly, and the filter has no influence on ranking in Google Search.

What this means for you

First check whether the property you are analyzing is top-level, because for path and subdomain properties the brand filter stays empty. Then it's best to run one query each with BRANDED and NON_BRANDED, start no earlier than February 21, 2026, and compare the totals with the performance report.

For Germany, Austria, and Switzerland combined, one query with filterLists and the codes DEU, AUT, and CHE is enough instead of three. Scripts and client dashboards that so far query per country can be shortened accordingly. Whether Lens or Circle to Search bring any visits to your pages at all is best shown first by a single query for webMultimodal, before you build a dashboard for it.

Google presented the new features on November 16, 2026, on the Search Central blog.

Sources

Comments

Register and comment.

Continue reading

You might also like

View all articles →