If you run a blog, an agency or a small business site, you have probably wondered how much of your Google traffic comes from people who already know your name and how much comes from people who found you cold. This guide is for marketers and site owners who use Search Console but are not developers. It starts with the latest news, then walks through the branded queries filter, who can use it and how to read the results.
The news: branded filtering reaches the Search Analytics API
On 16 November 2026, the Search Console team (Daniel Waisberg, Nati Yosephian and Karin Gadasi) published a Search Central post titled “New filtering and reporting capabilities in the Search Analytics API”. It says three Performance report capabilities are now available in the API, so they can be used for custom reporting and automated workflows:
- Branded queries: a
brandedClassificationfield lets you group or filter data to compare branded and non-branded performance. - Web multimodal: setting
typetowebMultimodalreturns data from Google Lens, Circle to Search on Android and image uploads in Google Search. - Multi-country and multi-device filters: a
filterListsfield lets one request cover several countries or devices, for example regional groups such as EMEA, LATAM or DACH.
The post also notes that the multimodal data is available in BigQuery, but only for properties with an active bulk data export. For the branded data, it says only eligible properties return it: for other properties the response will not include any rows.
The branded filter itself is not new to the Search Console interface. Google introduced it in the Performance report in November 2025. What changed this month is that the same split can now feed tools that read data through the API.
What counts as branded?
According to the Search Console Help page on common Performance report tasks, branded queries are “search queries that include your brand name, domain, or a brand-specific product or service”, including common misspellings and variations. Non-branded queries are those that do not include your brand name.
Google’s November 2025 announcement adds that this is not simple keyword matching. It describes an AI-assisted system that treats a query as branded if it contains your brand name in any language, including typos, or refers to a unique product or service of your site. Because the classification depends on context, the post warns that some queries may be misidentified. It also says the filter is a reporting tool and has no effect on how ranking works.
Which properties are eligible?
Eligibility is the part people most often get wrong, so here is what Google’s pages actually say, without added numbers.
- The Search Console Help page says: “The filter isn’t available for sub-properties” (its example is a path such as https://example.com/blog/) and not for “sites with a low number of impressions.”
- Google’s announcement says it is “only available for top level properties”, not URL-path properties or subdomain properties, and “only available for sites with a sufficient volume of queries and impressions for our signals.”
- The API reference says data is available “only for top-level properties with sufficient query and impression volume.”
None of these pages gives a specific impression or query count, so nobody outside Google can tell you the cutoff. If the filter does not appear for your property, a top-level property with more search visibility is the only route Google describes. A small or new site may simply not qualify yet.
How to use the filter in the Performance report
The Help page gives the steps in short form: open the filter bar, choose the Query filter, then select Branded or Non-branded. Here is the full routine.
- Open Search Console and select a top-level property.
- Go to Performance, then Search results.
- Set the date range you want to study. The Performance report defaults to the past three months.
- In the filter bar, choose the Query filter and pick Branded. Clicks, impressions, CTR and average position now describe only branded queries.
- Repeat with Non-branded and note the same four metrics.
The filter works across web, image, video and news search types, so you can switch the search type and compare. To see change over time, use the Compare option in the date filter: Google’s advanced filtering page says a Difference column then appears in the results table, and it suggests weekly or monthly granularity to smooth out day-of-week effects.
Google’s announcement also describes an Insights report card that splits total clicks between branded and non-branded traffic, which is a quick way to see the balance without building anything.
One date caveat: the Help page says data starts from when the filter was introduced on 11 March 2025, while the API reference says data is available starting 21 February 2026. These do not match, so check the earliest date your own report allows before planning a long year-over-year comparison.
How to read branded vs non-branded trends
Google’s Help page frames the two groups this way: branded traffic often comes from users already familiar with your site, while non-branded traffic can indicate new audience growth. Treat that as a starting point, not a verdict. The table below shows common patterns and the cautious reading for each.
| Pattern | Possible reading | What to check next |
|---|---|---|
| Total clicks flat, branded up, non-branded down | Existing audience is growing, but you may be losing discovery traffic | Pages that lost non-branded clicks; recent core or spam updates |
| Non-branded up, branded flat | Content is reaching new people | Which pages gained; whether those visitors return |
| Both down together | Could be seasonality or a site-wide issue | Compare against the same period and check indexing or technical problems |
Common mistakes
- Judging SEO by total clicks alone. A rise in branded clicks can hide a drop in non-branded visibility.
- Treating the split as exact. Google says misclassification can happen, so look at trends rather than single queries.
- Expecting the filter on a sub-property. Use the top-level property instead.
If you are not sure where to look after you split the data, our guide to finding quick SEO wins in the Performance report covers the non-branded pages and queries that usually deserve attention first.
What the API additions enable, in plain English
The API is a way for other software to ask Search Console for the same data you see in the Performance report. You will not need to write code to benefit from it, because dashboard and reporting tools use it behind the scenes. Check each tool’s own documentation to see whether it supports the new fields yet.
Based on the API reference, the additions allow three things:
- Automated branded reporting. A report or script can request branded and non-branded rows on a schedule instead of someone clicking through filters each month. The reference lists
BRANDEDandNON_BRANDEDas the values and supports only the equals operator. - Fewer requests for multi-market sites. With
filterLists, one request can cover several countries or devices. The reference says the dimension must becountryordevice, and that you cannot filter the same dimension in both a normal filter and a filter list. - Multimodal data outside the interface. Setting
typetowebMultimodalcovers Lens, Circle to Search and image-upload searches.
There is one technical limit worth passing to whoever builds your reports: the reference says filtering or grouping by brandedClassification cannot be combined with a query filter in the same request.
If you already build dashboards, see our walkthrough on a monthly marketing report in Looker Studio. For multimodal results in the interface, read what to check in multimodal search reporting.
Key takeaways
- On 16 November 2026 Google added branded classification, web multimodal data and multi-country or multi-device filter lists to the Search Analytics API.
- In the Performance report, open the filter bar, choose Query, then pick Branded or Non-branded.
- The filter needs a top-level property with enough query and impression volume. Google publishes no exact threshold.
- Read trends over matching periods, and remember that classification can be wrong for some queries.
- The API additions mainly help automated dashboards and multi-market reporting.
FAQ
Why can’t I see the branded queries filter?
Google says it is unavailable for sub-properties and for sites without enough query and impression volume. Check that you are in a top-level property. Beyond that, Google gives no further detail.
Does the filter change my rankings?
No. Google states that it is a reporting tool and has no effect on how Search ranking works.
What happens if I request branded data for an ineligible property through the API?
Google’s announcement says the response will not include any rows for properties that are not eligible.
Can I combine the branded filter with a specific query filter?
In the API, no: the reference says branded filtering or grouping cannot be combined with a query filter in one request. The Help pages do not say whether the interface behaves the same way, so test it in your own report.
Sources
- New filtering and reporting capabilities in the Search Analytics API (Google Search Central Blog)
- Search Analytics: query (Search Console API reference)
- Introducing the branded queries filter in Search Console (Google Search Central Blog)
- Performance report (Search results): Common tasks and use cases (Search Console Help)
- Performance report (Search results): Advanced filtering and comparison (Search Console Help)
- Performance report (Search results) overview (Search Console Help)
