On November 16, 2026, Google announced new filtering and reporting capabilities for the Search Analytics API. The additions bring branded query classification, web multimodal performance, and multi-country and multi-device filters into API-based reporting. For teams that already build dashboards, this creates a more direct way to answer questions that previously needed separate requests or keyword-pattern workarounds.
The new fields do not replace measurement planning. They make it easier to segment Search Console data, but teams still need to define what counts as a brand query, which markets matter, and how search visibility connects to business outcomes. This guide turns the announcement into a practical reporting plan.
Read Google’s announcement of the Search Analytics API update and the Search Analytics API reference for current parameter details and limits.
What changed in the API
Google added three options:
- Branded queries: Filter or group eligible property data by
brandedClassificationto compare branded and non-branded performance. Google notes that this data is available only for eligible properties; other properties may not return rows for it. - Web multimodal search: Set the search type to
webMultimodalto request performance data from Google Lens, Circle to Search on Android, and image uploads in Google Search. Google also says this data can be available in BigQuery for properties with active bulk data export. - Multiple countries and devices: Use the
filterListsfield to request several countries or devices in one API call, subject to supported combinations and values documented by Google.
These additions help answer specific questions. They do not create new rankings, guarantee more traffic, or mean every property will have data for every dimension.
Start with the decision, not the dashboard
Before changing an API query, decide what your team needs to learn. For example:
| Business question | Useful segment | What to compare |
|---|---|---|
| Are more people searching for our brand? | Branded vs. non-branded | Impressions, clicks, CTR, and conversions over time |
| Is product imagery earning search visibility? | webMultimodal vs. web |
Eligible impressions and clicks by page and period |
| Which markets have growing demand? | A selected country group | Pages, queries, and qualified actions by market |
| Is mobile visibility different from desktop? | Device filters | Clicks, impressions, and landing-page experience by device |
Keep each dashboard focused on a decision. A single chart that combines brand, device, country, and multimodal data can become difficult to interpret. Give users a clear default view and let them explore deeper segments when needed.
Build a branded search view carefully
Brand demand can rise because of offline activity, PR, partnerships, product launches, or existing customer behavior. Non-branded search can show whether your pages are reaching people who may not already know your company. Both views are useful, but neither is a complete measure of SEO success.
Use the branded classification only where Google makes it available. Confirm which property and date range are being queried, then compare branded and non-branded clicks and impressions over time. Pair this with landing pages and conversions where your analytics setup allows. A branded search increase should not be credited automatically to SEO work without checking other channels and events.
If you previously classified brand terms with regular expressions, document the old logic before replacing it. Compare results over an overlapping period so stakeholders understand why the metric may change. Google’s classification is not necessarily identical to every custom list a business has maintained.
Add multimodal reporting without overclaiming
Visual search can be important for businesses whose products, locations, or work are best understood through imagery. The webMultimodal search type provides a more direct way to view the eligible performance data described in Google’s announcement. Start by identifying pages whose images serve a real user purpose: product photography, diagrams, before-and-after examples, or location imagery.
Review whether those images are relevant, accessible, and supported by useful surrounding text. Write descriptive alternative text when the image conveys information, use sensible file names and dimensions, and ensure the page answers the visitor’s need beyond the image itself. These are sound content and accessibility practices; they are not a promise of multimodal impressions.
When you report this segment, state what it includes and the limits of the available data. Do not add multimodal clicks to another Search Console view if that would double count or obscure the reporting type.
Use market and device filters to find meaningful differences
Combining countries or devices in one request can simplify reporting for international teams. But a combined total can hide important local behavior. Keep a market-level view for decision-making, and use grouped segments when the goal is a broader regional trend.
For each market, verify that the page is intended for that audience and that language, currency, delivery, contact details, and legal information are suitable. For devices, connect visibility data to the actual landing-page experience: navigation, forms, image loading, and the ease of completing the next step.
Avoid conclusions from very small samples. Search Analytics API data is aggregated and subject to API limitations and privacy filtering. If a query returns fewer rows than expected, check the documentation and the UI report before treating the result as a complete dataset.
A reliable implementation workflow
- Read the current API documentation. Confirm the supported search types, dimensions, filters, and combinations before deployment.
- Keep the existing report. Add the new query as a separate view first; do not silently replace a trusted metric.
- Validate eligibility and responses. Test a known property and date range, and handle empty results without showing misleading zeros.
- Store definitions with the dashboard. Label the branded classification, multimodal type, included markets, and device scope.
- Compare with Search Console’s interface. Reconcile the same property, date range, and filters, allowing for API data behavior.
- Connect visibility to outcomes. Where consent and analytics implementation allow, assess whether the landing pages support qualified enquiries or sales.
- Review the pipeline. Log API errors, refresh schedules, and schema changes so missing data is visible to the team.
A practical reporting cadence
Use a weekly check for major anomalies and a monthly review for strategy. Weekly totals are useful for spotting tracking or deployment problems, but they may be too volatile for decisions about content investment. Monthly and year-over-year comparisons can help reduce noise, especially in seasonal markets.
At the monthly review, ask which non-branded topics are gaining visibility, whether branded demand changed after a campaign, which pages attract relevant market demand, and whether image-led pages have measurable search exposure. Record both the insight and the next action. A dashboard that does not change a decision is probably too complex.
Frequently asked questions
When did Google announce these Search Analytics API features?
Google published the announcement on November 16, 2026. The update covers branded queries, web multimodal reporting, and multi-country and multi-device filters.
Will every Search Console property return branded query data?
No. Google says branded classification is available for eligible properties. Other properties may not return rows for that option.
What does webMultimodal include?
Google describes it as performance data from Google Lens, Circle to Search on Android, and image uploads in Google Search. Check the current API documentation for the supported values and constraints.
Should I replace my existing SEO dashboard?
Add and validate the new views alongside existing reporting first. Keep metric definitions visible and only retire an old method after the team understands how the new data compares.
For help connecting search data to an actionable growth plan, explore our SEO services.





