Search Analytics API adds branded query split, webMultimodal type and multi-country filters

Search Analytics API adds branded query split, webMultimodal type and multi-country filters

SEONovember 17, 2026
By Antonio Fernandez

TL;DR

  • Google added three options to the Search Analytics API on 16 November 2026: the brandedClassification dimension, the webMultimodal search type and the filterLists field.
  • brandedClassification returns BRANDED or NON_BRANDED, supports only the "equals" operator, cannot be combined with a query filter, and has data from 21 February 2026 onward.
  • Branded data exists only for top-level properties with sufficient query and impression volume. Google gives no threshold, and ineligible properties get a response with no rows.
  • webMultimodal covers Google Lens, Circle to Search on Android and image uploads. Google says BigQuery bulk export will carry it too, with no date.
  • filterLists accepts several ISO 3166-1 alpha-3 country codes or the devices DESKTOP, MOBILE and TABLET in one request, but not the same dimension in both filters and filterLists.

Google added three reporting options to the Search Analytics API on Monday 16 November 2026: a branded and non-branded split of queries, a search type for Google Lens and Circle to Search traffic, and filters that accept several countries or devices in one request. All three already existed in the Search Console Performance report. From 16 November they can be pulled by any dashboard, connector or script that calls the API, with limits that Google spells out in the API reference and that are easy to miss.

What Google announced on 16 November 2026

The announcement came in a post on the Google Search Central Blog titled "New filtering and reporting capabilities in the Search Analytics API", signed by Daniel Waisberg, Nati Yosephian and Karin Gadasi of the Search Console team. Google wrote that over the past year it had added the branded queries filter, web multimodal search reporting, and multi-country and multi-device filtering to the Performance report, and that it was now bringing all three to the API "following ecosystem requests to make this data available for custom reporting and automated workflows".

The post lists the additions as three new options:

  • Branded queries. Group or filter data by brandedClassification to compare branded and non-branded performance.
  • Web multimodal. Set type to webMultimodal to get performance data from Google Lens, Circle to Search on Android, and image uploads in Google Search.
  • Multi-country and multi-device filters. Use the new filterLists field to filter by several countries or devices in a single request.

Google described the gain as less manual work. In its words, "Instead of stitching together separate requests or maintaining complex keyword regex lists, you can now query a group of countries (such as EMEA, LATAM, or DACH) and device combinations in a single API call, and automatically segment branded from non-branded traffic in your dashboards."

The three additions and their documented limits

The blog post is short. The conditions sit in the API reference for the searchanalytics.query method, which Google's page shows as last updated on 16 November 2026. The table below sets each addition against the way it is requested and the limits the reference documents.

The three additions and their documented limits
AdditionHow it is requestedLimits documented by Google
Branded queriesbrandedClassification as a grouping dimension or as a filter, with the values BRANDED and NON_BRANDEDOnly the "equals" operator is supported. It cannot be combined with a "query" filter in the same request. Data starts on 21 February 2026 and exists only for top-level properties with sufficient query and impression volume.
Web multimodaltype set to webMultimodalCovers Google Lens, Circle to Search on Android and image uploads in Google Search. Google says the data "will also be available" in BigQuery for properties with an active bulk data export, with no date given.
Multi-country and multi-device filtersfilterLists inside dimensionFilterGroups, with dimension set to "country" or "device" and a list of expressionsCountries use ISO 3166-1 alpha-3 codes. Devices are DESKTOP, MOBILE and TABLET. One request cannot filter the same dimension in both filters and filterLists.

Branded query classification: what the API returns and what it refuses

The branded split is the addition most reporting teams will reach for first, and it carries the most conditions. According to the API reference, brandedClassification filters results "against the specified branded query classification", and "only the 'equals' operator is supported". The other operators the API offers for ordinary filters (contains, notContains, notEquals and the two regular expression operators) are not available for this dimension.

The reference also states that "Filtering or grouping by 'brandedClassification' can't be combined with a 'query' filter in the same request." In practice, a request cannot ask for the branded share of queries that contain a product name. Trade publication PPC Land pointed out that the sentence mentions a query filter only, and that grouping by query next to brandedClassification is not addressed by it. Until Google documents that case, the safe assumption is to test it on a real property before building a report around it.

History is limited too. The reference says branded data "is available starting February 21, 2026". A year-on-year brand comparison for January is therefore not possible from this field, however far back the rest of the property's data goes.

Ineligible properties get an empty response, not an error

Google's blog post states: "As in Search Console, this data is only available for eligible properties. For other properties, the response won't include any rows." The reference narrows eligibility to "top-level properties with sufficient query and impression volume". Neither page gives a number for "sufficient".

PPC Land noted that neither document describes an error message or a field that tells the caller a property is ineligible. A dashboard that reads zero rows as zero branded clicks would therefore report a wrong figure rather than a missing one. Anyone wiring this into a client report should treat an empty response as "not eligible or no data" and label it that way.

Google applies the label

Before this change, a branded versus non-branded report from API data needed a hand-written rule, usually a regular expression listing every spelling of the brand. Google's post calls that "maintaining complex keyword regex lists". With brandedClassification, Google's own classifier decides which queries count as branded. PPC Land observed that the reference page gives no mechanism for reviewing or editing that classification. Google's November 2025 announcement of the branded queries filter, which the API reference links to, says the classification comes from an internal, AI-assisted system that includes the brand name in all languages and typos, and that some queries may occasionally be misidentified.

The webMultimodal search type: Lens and Circle to Search traffic by API

The type parameter decides which Google surface a request reports on. The API reference now lists seven values: discover, googleNews, news, image, video, web (the default) and webMultimodal. It defines webMultimodal as "Search results from Google Lens, Circle to Search on Android, and image uploads in Google Search."

The Search Console interface gained a multimodal search type in late September 2026. PPC Land dates that rollout to 24 September 2026, and Relevant Audience covered it on 25 September 2026, noting that the interface version came with no query data. Google's 16 November post and the API reference do not say whether the query dimension returns rows when type is webMultimodal, so that is another thing to test before promising it in a report.

Google added one line about data warehouses: "This data will also be available in BigQuery for properties with an active bulk data export." The sentence is in the future tense and has no date attached.

filterLists: several countries or devices in one request

Until 16 November 2026, a filter in the Search Analytics API matched one value per entry, and the reference still describes the only supported group type as "and", meaning every filter in a group must be true. There was no documented way to say "any of these countries" inside a single filter. Google's post describes the old routine as "stitching together separate requests".

The new filterLists field changes that for two dimensions. The reference describes it as "Zero or more multi-value dimension filters to test against the row" and explains that "A row matches a filter list if its value for the specified dimension equals any of the provided expressions." The dimension must be "country", using three-letter ISO 3166-1 alpha-3 codes, or "device", using DESKTOP, MOBILE or TABLET. Page, query and search appearance are not listed as filterLists dimensions.

One rule limits how the old and new filters mix. The reference states that "a single request cannot filter on the same dimension in both filters and filterLists at the same time". A country list in filterLists can sit next to a device filter in filters. A country list and a separate country filter in the same request cannot.

How the three features reached the API

None of this is new data. Google's post says each capability was introduced in the Performance report "over the past year". PPC Land's account puts the branded queries filter in the interface in November 2025, the multimodal search type on 24 September 2026, and the option to view several countries as one total on 6 October 2026, the last of these announced through a Google Search Central post on LinkedIn. Relevant Audience published a how-to on the branded queries filter on 14 March 2026.

What changed on 16 November 2026 is access. The interface serves a person looking at one property. The API serves the connectors and scripts behind Looker Studio reports, rank trackers, data warehouses and in-house dashboards, where the same query runs across many properties on a schedule.

What did not change in the Search Analytics API

The older limits of the method still apply to the new options. The API reference continues to say that the API "is bounded by internal limitations of Search Console and does not guarantee to return all data rows but rather top ones". The rowLimit parameter accepts 1 to 25,000 rows per request with a default of 1,000, and startRow pages through the rest. Results are sorted by clicks in descending order unless grouped by date. Click-through rate is returned as a value from 0 to 1.0, not as a percentage.

What to check in your own reporting

This section is analysis by Relevant Audience and is not part of Google's announcement.

  • Find out which properties are eligible before promising a brand split. Run a request grouped by brandedClassification on each property. Rows mean the property qualifies. An empty response means it does not, or has no data for the range.
  • Query the top-level property. The reference limits branded data to top-level properties. Google's November 2025 announcement of the filter, which the reference links to, says URL path properties and subdomain properties do not qualify. If a property that covers only a subfolder returns nothing, run the same request against the property for the whole site before concluding the data is missing.
  • Keep the old regex report running for a while. Google's label and a hand-written brand list will not agree on every query, and the difference shows where the two definitions diverge.
  • Start date ranges for brandedClassification on or after 21 February 2026.
  • Check whether your connector exposes the new fields. Google has changed the API. Third-party connectors and dashboards have to add brandedClassification, webMultimodal and filterLists on their own schedule.

Teams that want a second pair of eyes on how organic reporting is set up can start with an SEO audit that includes the Search Console configuration.

What this means for Thai marketers

This section is also analysis. Google's post does not mention Thailand or any other individual market apart from the regional examples EMEA, LATAM and DACH.

The filterLists field takes ISO 3166-1 alpha-3 country codes, and Thailand's code in that standard is THA. A Thai brand selling across Southeast Asia could therefore request one combined figure for a list of country codes of its choosing, instead of one request per market. The API reference also states that brandedClassification needs "sufficient query and impression volume" without quantifying it, so smaller Thai sites should expect that the branded split may return no rows for them.

Many Thai brands are searched under both a Thai-script name and an English or transliterated one. Google's November 2025 announcement says the classification includes the brand name in all languages and typos, and that some queries may occasionally be misidentified. The practical step is to compare Google's BRANDED totals against a known list of brand spellings in both scripts before using the figure in a board report. Brand and non-brand organic clicks belong next to GA4 conversions in the same dashboard, which is where a clean Google Analytics 4 setup matters.

Questions about the Search Analytics API update

What did Google add to the Search Analytics API on 16 November 2026?

Google added three options: the brandedClassification dimension for splitting branded and non-branded queries, the webMultimodal search type for Google Lens, Circle to Search and image upload traffic, and the filterLists field for filtering by several countries or devices in one request. All three were already in the Search Console Performance report.

Why does my brandedClassification request return no rows?

The most likely reason is that the property is not eligible. Google says the data exists only for top-level properties with sufficient query and impression volume, and that other properties get a response with no rows. Google also says the data is available only from 21 February 2026, so earlier dates are not covered.

Can I change which queries Google counts as branded?

Google's documentation describes no way to do that. The API reference lists two values, BRANDED and NON_BRANDED, and PPC Land noted that it offers no mechanism to review or edit the classification. A site that needs its own definition still has to maintain its own brand term list.

Does the multimodal data in the API show the queries people searched?

Google has not said. The 16 November 2026 post and the API reference describe webMultimodal as a search type covering Lens, Circle to Search on Android and image uploads, and do not address the query dimension. The Search Console interface version launched in September 2026 without query data.

Is the new API data available for Thai websites?

The API is not restricted by country, and Google's post names no excluded markets. A Thai site can use filterLists and webMultimodal like any other property. The branded split depends on the property meeting Google's unquantified volume threshold, and Google says properties that are not eligible get no rows.

The short version

Search Console's branded split, multimodal reporting and multi-country filters can now be automated, and the conditions in the API reference decide how useful they are for a given property. Check eligibility, respect the 21 February 2026 start date, and treat empty responses as missing data. For help turning Search Console data into reporting a marketing team can act on, talk to the SEO team at Relevant Audience.

Antonio Fernandez

Antonio Fernandez

Founder and CEO of Relevant Audience. With over 15 years of experience in digital marketing strategy, he leads teams across southeast Asia in delivering exceptional results for clients through performance-focused digital solutions.

Share to:
Copy link:

Read us often? Add Relevant Audience as a preferred source so our articles surface more in your Google results.