# Search Console API finally exposes branded queries and visual search — with eligibility traps

Google has brought branded-query segmentation, image-led search reporting and combined country/device filters into the Search Analytics API, allowing automated dashboards to reproduce previously interface-only views — but not for every property.

The November 16 Search Analytics API update unlocks brand and multimodal reporting for developers, with eligibility, historical coverage and client-library caveats.

- Status: Active
- Published: 2026-11-18T06:18:12+13:00
- Updated: 2026-11-18T06:18:12+13:00
- Categories: Marketing & Distribution, SEO & Search, GEO & AI Search, Conversion & Analytics
- Tags: analytics, API migration, Google Search Console, SEO
- Canonical HTML: https://beyondthe.news/dossiers/google-search-console-api-branded-multimodal-filterlists-november-2026

## What changed

On November 16, 2026, Google added three reporting capabilities to its Search Analytics API: the brandedClassification dimension/filter for branded versus non-branded queries; a webMultimodal search type for Lens, Circle to Search and image-upload searches; and filterLists to combine multiple countries or devices in a request. These features existed in Search Console's interface before API access. Google says multimodal data also appears in BigQuery bulk exports where enabled.

## Why it matters

Developers building SEO dashboards and agency reporting no longer need to approximate brand splits entirely with hand-maintained keyword rules or stitch together multiple API calls for every country/device. Visual-search performance can be monitored automatically. But silently empty branded responses and type-definition lag can mislead dashboards, and none of these dimensions should be confused with proof of AI answer referrals or conversion impact.

## Branded reporting is restricted, not universal

Group or filter by brandedClassification using BRANDED or NON_BRANDED. Google's API reference restricts the data to eligible top-level properties with sufficient search volume, beginning February 21, 2026. Unsupported properties return no rows, not an explicit ineligibility error. Branded classification cannot be combined with a query filter in the same request. Compare the new classification with an existing brand-keyword rule before changing longitudinal reporting; pre-February history cannot be reconstructed from this API dimension.

## Visual search becomes scriptable

Set type to webMultimodal for Google Lens, Circle to Search on Android and image-upload searches. This describes image-led Google web-search entry points; it is not a direct AI Mode/AI Overview referral counter. Google says properties with active bulk export can access the multimodal data in BigQuery too. Establish a separate baseline rather than silently combining this new series with conventional web-search trends.

## Fewer requests for regions and devices

The filterLists field supports several countries or several devices in a single Search Analytics query. This reduces per-country/per-device request fan-out for regional reporting, but API users should follow the documented filter-group structure and supported combinations instead of assuming arbitrary OR logic across unrelated dimensions.

## Client libraries and dashboards may lag the live API

Independent implementation reporting on November 16 found that Google's live discovery document already described the new fields while some generated language bindings lagged: a Python client passed through request bodies despite an older bundled description, whereas a Node TypeScript type lacked filterLists. These are observed client-version caveats, not proof every SDK or future version behaves the same. Verify current library types and the wire request before deploying.

## What to do now

Test the new query shapes against an eligible property; log and distinguish empty branded responses from zero actual traffic; compare classification with previous branded regex logic; version dashboards so historical trends remain interpretable; and retain analytics/conversion instrumentation for downstream outcomes. Google's announcement does not claim new Search ranking signals or extra organic traffic.

## Key details

- Announced November 16, 2026 in Google's Search Central blog.
- brandedClassification groups or filters BRANDED and NON_BRANDED only for eligible top-level properties.
- Branded history starts February 21, 2026; brandedClassification cannot be combined with a query filter.
- type=webMultimodal covers Lens, Circle to Search and image uploads.
- filterLists combines multiple countries or devices in one API request.
- Some client-library generated types may lag the live discovery document.

## Builder takeaways

- Update automated reporting only after checking the API reference and eligibility behaviour.
- Treat zero branded rows as possibly unsupported data, not automatically zero branded searches.
- Preserve a separate baseline for multimodal discovery; do not label it AI-answer traffic.
- Test client-library compatibility, especially typed SDKs, before deploying new filters.

## What to watch

- Whether Google expands branded-query eligibility and history.
- Updates to generated client-library types for filterLists and webMultimodal.
- Whether Google adds more granular AI-answer referral attribution to the API.

## Uncertainties

- Google does not guarantee branded data for small or sub-property sites.
- No independent evidence here establishes the business impact of the new reporting options.
- SDK compatibility depends on library and version.

## Sources

- [New filtering and reporting capabilities in the Search Analytics API](https://developers.google.com/search/blog/2026/11/search-analytics-api-update) — Google Search Central · primary_announcement · 2026-11-16T00:00:00+13:00. Official launch and three new API capabilities.
- [Search Analytics query API reference](https://developers.google.com/webmaster-tools/v1/searchanalytics/query) — Google for Developers · primary_documentation · 2026-11-17T00:00:00+13:00. Live documentation for eligible branded properties, February 21 history and filter restrictions; date reflects inspection, not asserted page publication.
- [Google Search Analytics API gains new filters and reporting](https://searchengineland.com/google-search-analytics-api-gains-new-filters-and-reporting-502173) — Search Engine Land · independent_reporting · 2026-11-16T00:00:00+13:00. Independent specialist confirmation of release and scope.
- [The Search Console API now splits brand traffic, Lens searches and country groups](https://thesearchpost.com/search-console-api-branded-queries) — The Search Post · independent_analysis · 2026-11-16T00:00:00+13:00. Reported concrete Python and Node SDK compatibility checks; not a blanket SDK compatibility claim.

