Search Analytics API Gets Branded, Multimodal, and Multi-Filter Capabilities
Google

Search Analytics API Gets Branded, Multimodal, and Multi-Filter Capabilities

In brief

Google has expanded the Search Analytics API to include three major capabilities previously exclusive to the Search Console Performance report: branded query classification, web multimodal search reporting, and multi-country plus multi-device filtering in a single API call. These additions respond directly to ecosystem demand from developers and tool builders who need to automate custom reporting workflows at scale. Marketing teams and agencies can now build richer, more automated dashboards without manual workarounds.

Key points

  • Three capabilities from the Search Console Performance report are now available in the Search Analytics API: branded queries filter, web multimodal search reporting, and multi-country plus multi-device filtering.
  • The new brandedClassification dimension allows API users to group or filter data by branded versus non-branded queries, though this data is only accessible for eligible properties and will return no rows for others.
  • Setting the search type to webMultimodal retrieves performance data specifically from Google Lens, Circle to Search on Android, and image uploads within Google Search, providing visibility into this growing surface.
  • The new filterLists field enables users to combine multiple countries and multiple devices in a single API request, replacing the need to issue separate calls or maintain complex filtering logic externally.
  • Web multimodal data will also be available in BigQuery for properties that have an active bulk data export, expanding the possibilities for large-scale data analysis.
  • These filters are designed to work together, allowing marketers to combine dimensions such as tracking brand growth across specific regional hubs like EMEA, LATAM, or DACH while simultaneously filtering by device type.

Analysis

Until now, the richer filtering capabilities introduced in the Search Console UI over the past year were not accessible via the API, forcing teams that rely on automated workflows to either work manually in the interface or maintain complex workarounds such as regex-based keyword lists for brand segmentation. By bringing these three capabilities into the Search Analytics API simultaneously, Google closes a significant gap between what analysts could see in the UI and what they could automate programmatically.

The branded query classification feature is particularly significant for performance reporting because distinguishing brand-driven traffic from non-brand organic growth is fundamental to understanding the true SEO health of a website. Without this filter at the API level, teams were forced to maintain and update keyword lists manually, an approach that is both error-prone and difficult to scale across large or multi-brand organizations. The brandedClassification dimension removes this friction for eligible properties.

The addition of web multimodal as a search type in the API reflects the growing importance of visual and AI-assisted search surfaces. Google Lens, Circle to Search, and image uploads now represent meaningful traffic sources for many verticals, including e-commerce, travel, and publishing. Having this data accessible programmatically and in BigQuery means performance teams can integrate multimodal metrics into their existing dashboards and monitoring systems rather than treating them as a separate reporting silo.

The filterLists field addresses a practical pain point for international businesses and agencies managing multi-market SEO. Previously, pulling performance data for a regional cluster required issuing multiple API calls and aggregating the results client-side, adding complexity to data pipelines. A single call covering a group of countries and device combinations reduces latency, simplifies pipeline architecture, and makes it easier to maintain consistent reporting logic across large-scale operations.

The fact that all three filters are designed to work in combination is worth emphasizing. A team can, for example, query non-branded multimodal performance for mobile users across DACH markets in a single request, a level of specificity that simply was not achievable via the API before this update. This combinability is what makes the update more than the sum of its parts and opens the door to genuinely new reporting use cases.

What to do

  • Audit your current Search Analytics API integration and identify any manual workarounds you have built for brand query segmentation or multi-country filtering, then plan to replace them with the new brandedClassification dimension and filterLists field respectively.
  • If your property is eligible for branded query data, build a dedicated dashboard segment that tracks the ratio of branded to non-branded impressions and clicks over time, as this ratio is a strong proxy for brand authority growth and the effectiveness of non-brand SEO efforts.
  • Activate the webMultimodal search type in your API queries and, if you have a BigQuery bulk data export configured, begin pulling this data into your data warehouse to establish a baseline before optimizing for visual search surfaces.
  • For agencies and teams managing multiple international markets, restructure your reporting pipelines to use the filterLists field to group countries by commercial region (such as EMEA, LATAM, or APAC) and reduce the number of API calls needed, which will also reduce the risk of hitting quota limits.
  • Combine the three new capabilities in a single query where analytically relevant, for instance monitoring non-branded multimodal performance by device type for your top markets, to uncover cross-dimensional insights that were previously impossible to surface without significant data manipulation.
  • Review the official Search Analytics API documentation for the full list of supported values and valid filter combinations, particularly for filterLists, to ensure your implementation is correctly structured from the start and avoids returning incomplete or empty result sets.
Impact

These API updates give SEO professionals and developers programmatic access to branded versus non-branded traffic segmentation, multimodal search performance data (including Google Lens and Circle to Search), and regional filtering across country groups, enabling far more granular and actionable performance monitoring directly within automated reporting pipelines.

Official source
Never miss an update

Product news, algorithm updates and best practices, straight to your inbox.

Back to the tracker

Stay one step ahead of the algorithms

Pulsar tracks your Google rankings, your AI visibility and your social media in one dashboard. 14-day trial, no credit card required.

Start a free trial