Skip to content
Theme
OnDevice Tools

Internet & SocialSearch & Google

Google Search Analytics API adds branded and multimodal filters

Google has brought branded query, multimodal and multi-country/device filtering to the Search Analytics API, according to Search Engine Roundtable. The update gives custom reporting tools access to data already available in Search Console.

Google Search Analytics dashboard illustration with branded query and multimodal filters

Key takeaways

  • Google added branded query, multimodal and multi-country/device filters to the Search Analytics API.
  • The branded option uses brandedClassification and is limited to eligible properties.
  • The webMultimodal type returns data from Google Lens, Circle to Search on Android, and image uploads.
  • The filterLists field allows several countries or devices in one request.
In this article
  1. Search Analytics API update
  2. Branded query filtering
  3. Multimodal search data
  4. Country and device filters
  5. Why the update matters

Search Analytics API update

Illustration: code, search, update, Google Search Console logo and the labels Bigquery, Circle to Search, Google Lens

On 16 November 2026, Search Engine Roundtable reported a Google update. The update expands the Search Analytics API with new filters and reporting features.

The new options cover branded queries, web multimodal data, and country or device filters. They were already available in the Search Console web interface.

Google's Search Console team said the change follows ecosystem requests. The team members named are Daniel Waisberg, Nati Yosephian and Karin Gadasi. They said all three capabilities are now supported in the API.

The Search Analytics API lets other software request Search Console performance data. The update makes some interface options available through that route. Google says the aim is custom reporting and automated workflows.

Branded query filtering

One new option is branded query filtering. It uses a field called brandedClassification. This field can group or filter data. The option is intended to compare branded and non-branded performance.

Google says the behaviour matches Search Console. The data is only available for eligible properties. For properties that are not eligible, the API response will not include any rows.

This limit is important for developers. They should check property eligibility before expecting branded data. The API will otherwise return no branded rows for that property.

The brandedClassification field is the key control. It allows grouping or filtering in the API. This mirrors the branded comparison in Search Console. The report ties the new option to eligible properties.

Multimodal search data

The API also adds support for web multimodal data. Requests can set the type value to webMultimodal. This returns performance data from three named sources.

The sources are Google Lens and Circle to Search on Android. The report also lists image uploads in Google Search. These are the only sources listed in the report. The option covers visual and image-based search entry points.

The addition brings this data into the API. Google also says the data will be available in BigQuery. That applies to properties that have an active bulk data export. BigQuery is another route.

The webMultimodal type is the value used to request this data. The report names this as the request type for multimodal data. The report lists these sources for the new type.

Country and device filters

The third addition is a new filterLists field. It allows a single API request to include several countries or devices. This means one request can cover multiple values.

The option is aimed at reports that compare several markets or device types. It brings the API closer to Search Console filtering. The filterLists field is new to the API.

For developers, the change affects query construction. They can include multiple countries or devices in one request. This supports reports that need multiple values.

The field is designed for multi-country and multi-device requests. It is a new filter option in the API. It adds a way to combine several values in one call. The report names filterLists as the new field.

Why the update matters

The update gives custom reporting tools more Search Console segmentation. Teams can request branded comparisons, multimodal performance, and multi-country or multi-device views. The API now supports these options directly.

Google says the additions respond to ecosystem requests. The company points to custom reporting and automated workflows. The update focuses on the API rather than the web interface.

The branded option has a clear limit. Only eligible properties receive rows. The multimodal option depends on the webMultimodal type and, for BigQuery, an active bulk data export. The filterLists field is the main change for multi-country and multi-device requests.

The changes are intended to support automated workflows. They also make Search Console data available through the API. Google says the update follows requests from the search ecosystem.

Sources

  1. Google Search Analytics API Adds Branded Queries, Multimodal & Country/Devices FiltersSearch Engine Roundtable

Tags

Spotted a mistake? See our corrections policy. Read how News by OnDevice works in our editorial policy.