TrackingDesk

analytics·advertising·ai

Search Console's API splits brand clicks, from 21 February only

Published 2026-11-17 ·Google primary source

What it means

Organic brand clicks are the baseline every paid brand search argument needs, and from 16 November a script can pull them daily next to ad spend. But Google's AI classifier decides what counts as branded, not your brand keyword list, the data starts on 21 February 2026, and a property Google finds ineligible gets no rows rather than an error, so a dashboard can read an empty answer as zero brand traffic.

Until yesterday, the brand and non-brand split in Search Console lived in the web interface. A script that wanted it kept a regex of brand terms. From 16 November, the Search Analytics API returns Google’s own split. That is the organic baseline a paid brand search argument needs, now available every day by API. It has three limits that a dashboard will not show you.

What changed

Google’s Search Central post of 16 November adds three options to the API:

  • brandedClassification, to group or filter rows as BRANDED or NON_BRANDED.
  • webMultimodal, a search type for Google Lens, Circle to Search on Android and image uploads.
  • filterLists, to filter by several countries or devices in one request.

The brand split is the one that matters for paid search. Search Console’s version of “branded” is not a keyword list. Google’s 2025 announcement says an internal, AI-assisted system decides it. It counts the brand name in all languages, its misspellings, and products or services unique to the site, even when the query does not contain the brand name.

We read the API’s discovery document today, the file client libraries are generated from. Revision 20261115 already lists BRANDED_CLASSIFICATION as a dimension and a filter, and WEB_MULTIMODAL as a search type. A filterLists entry takes up to 1,000 values, for COUNTRY and DEVICE only.

The read: a baseline with no last year

The history starts on 21 February 2026. The API reference says so. That is about 38 weeks of brand data on the day it reaches the API. Two things a performance team would do first need more:

  • A year-on-year brand read for the holidays. There is no Black Friday 2025 in the classified data. This year’s peak also lands on a moving baseline: Google’s November core update is changing rankings through the same weeks.
  • A brand series for a media mix model. The models in our MMM comparison want two years of weekly data, 104 points. 38 is not enough.

Google’s definition will not match yours. Your brand search campaign bids on a keyword list you wrote. Search Console’s classifier adds typos, other languages and product names, and Google says some queries “may occasionally be misidentified”. So “organic branded clicks” and “paid brand clicks” are two different sets of queries. Before you divide one by the other, compare the lists. The API reference says you cannot combine the brand filter with a query filter in one request. It does not say you cannot group by query and brandedClassification together, which is how you would compare the lists. We had no eligible property to test it on.

An ineligible property returns nothing, not an error. The brand split is only for top-level properties with enough queries and impressions. URL path and subdomain properties are out. For those, Google’s post says “the response won’t include any rows”. A dashboard that sums the rows shows zero brand clicks, and a report built on it can show zero branded traffic where there is plenty.

The BigQuery export does not have it. Search Console’s bulk export to BigQuery carries a flag for rare, anonymized queries. Its table guide, read today, lists no brand field, and no multimodal search type either, although the post says multimodal data is coming to BigQuery. If your warehouse is built on the export, the brand split still comes from the API.

The days are Pacific. The API’s start and end dates are in PT. Join it to ad data by day only if the ad account reports in the same time zone, or the late-night clicks land on the wrong date.

What to do

  • Run one request with brandedClassification as the only dimension. No rows means the property is not eligible. Record that, so nobody reads it as zero brand traffic.
  • Pull the query list with both labels and compare it to your brand campaign keywords before you put organic and paid brand clicks in one chart.
  • Start the series now and keep it. Store the daily split from 21 February 2026 in your own warehouse, so next November has a year to compare against.

The split shows how many people reach you by searching your name without an ad. It does not show what your brand campaign adds to that number. That needs a holdout, and Google reports a lift result from 50% certainty, which is a coin toss.

Sources

  • Google's Search Central blog, in a post dated 16 November 2026, says three Search Console Performance report capabilities come to the Search Analytics API: the branded queries filter, web multimodal search reporting, and multi-country and multi-device filtering.Googleverified 2026-11-17
  • The same post says data can be grouped or filtered by brandedClassification to compare branded and non-branded performance, that this data is only available for eligible properties, and that for other properties the response won't include any rows.Googleverified 2026-11-17
  • The same post says type webMultimodal returns performance data from Google Lens, Circle to Search on Android and image uploads in Google Search, and that the new filterLists field filters by several countries or devices in one request.Googleverified 2026-11-17
  • The searchanalytics.query reference says brandedClassification supports only the equals operator, takes the values BRANDED and NON_BRANDED, and that filtering or grouping by it can't be combined with a query filter in the same request.Googleverified 2026-11-17
  • The same reference says branded classification data is available starting February 21, 2026, and only for top-level properties with sufficient query and impression volume.Googleverified 2026-11-17
  • The same reference gives startDate and endDate in PT time (UTC - 7:00/8:00), and says a single request cannot filter on the same dimension in both filters and filterLists.Googleverified 2026-11-17
  • Google's branded queries filter announcement (20 November 2025, updated 11 March 2026 to say it is available to all eligible sites) says a branded query includes the brand name, its variations and misspellings, and brand-related products or services, and that the classification is not a regular expression but an internal, AI-assisted system that includes the brand name in all languages.Googleverified 2026-11-17
  • The same announcement says some queries may occasionally be misidentified, and that the filter is not available for URL path properties or subdomain properties, nor for sites without a sufficient volume of queries and impressions.Googleverified 2026-11-17
  • The Search Console API discovery document, revision 20261115, lists BRANDED_CLASSIFICATION as a group-by dimension and a filter dimension, WEB_MULTIMODAL as a search type, and says filterLists supports COUNTRY and DEVICE only, with at most 1,000 expressions in one filter list.searchconsole.googleapis.comverified 2026-11-17
  • Search Console's bulk data export table guidelines list the export fields, including query, is_anonymized_query, country, search_type and device, with search_type values web, image, video, news, discover and googleNews. The page lists no branded classification field.Googleverified 2026-11-17