Search Console API: Branded, Lens and Multi-Country Filters
Google added branded queries, Lens and Circle to Search data and multi-country filters to the Search Analytics API. What changed and what to check this week.
On 16 November Google's Search Console team brought three filters from the Performance report into the Search Analytics API: branded queries, web multimodal search, and multi-country or multi-device filtering. For anyone who builds SEO dashboards, one manual export step disappears.
What is new in the API
According to the Google Search Central blog, the API now covers three things:
- Branded queries. The
brandedClassificationfield lets you group or filter by branded and non-branded queries and compare the two. It works only for eligible properties; for all others the response contains no rows. - Web multimodal. Set
typetowebMultimodalto get performance data from Google Lens, Circle to Search on Android and image uploads in Google Search. The same data is available in BigQuery for properties with an active bulk data export. - Several countries or devices in one request. The new
filterListsfield filters by multiple countries or devices at once, for example a regional group such as EMEA, LATAM or DACH combined with a device filter.
The post gives no rollout dates and sends readers to the API documentation for syntax.
Who gets the branded split
As Google explained when it announced the branded filter in the Performance report, it is meant for top-level (domain) properties, not URL-path or subdomain properties, and needs a sufficient volume of queries and impressions. Classification is done by an internal AI-assisted system, so some queries can be misclassified.
Why it matters for SEO and link building
Branded queries grow with advertising, PR and word of mouth. Non-branded queries show whether people find you without already knowing your name. If you invest in content or links, the honest signal is impressions and clicks on non-branded queries over several weeks, not the branded ones. Now that the split is in the API, you can pull it into Looker Studio, Google Sheets or your own script and track it automatically. It is a measurement tool, not a promise of any result.
What to do this week
- Open the Performance report for your domain property and check whether the branded filter is there. If it is not, the API will return no rows for
brandedClassification, so do not treat that as a bug. - If it is there, pull weekly impressions and clicks for non-branded queries into a sheet and record a baseline before your next round of SEO work.
- For a multi-market site, use
filterListsto group countries into regions and compare them by device. - For e-commerce or a visual catalog, query
webMultimodalto see how much attention comes from Lens and Circle to Search. - If you want help choosing pages worth strengthening, the free PromoPilot SEO Radar is one place to start.
Source: New filtering and reporting capabilities in the Search Analytics API by the Search Console team, 16 November 2026. Background: Search Console branded filter announcement, 20 November 2025. Retold by the PromoPilot team.