Skip to content

Marketing and SEO

Search Console API: new filters for brand, countries and visual search

Google is bringing three features already seen in the interface to the Search Console API: branded queries, multi-country and device filters, and visual search data. Here is what changes for companies that measure SEO.

6 min read

Google has updated the Search Console API, the channel through which software and dashboards read a website's search data without going through the interface. You can now automatically separate traffic from people searching for your brand, filter several countries in a single request and measure visits from Google Lens. For a company that exports or sells online, this means more honest SEO reports and less manual work.

At a glance

  • The Search Console API now lets you distinguish branded queries from non-branded ones, but only for properties that Google considers eligible.
  • With the new filterLists field you can request data for several countries or devices in a single request, which is useful if you work on foreign markets.
  • The new webMultimodal data type measures performance from Google Lens, Circle to Search on Android and images uploaded to Google Search.
  • The updates mainly matter to anyone who already has dashboards or automated reports: if you check Search Console manually, you will find the same features in the interface.

What Google has announced for the Search Console API

Over the past year Google added three tools to the Performance report in Search Console: the branded queries filter, multimodal search data and multi-country and multi-device filters. Until now, however, they were only available within the interface. With the announcement published on the Google Search Central blog, they are also coming to the Search Analytics API, the part of the API that returns clicks, impressions and positions.

In practice, anyone building automated reports, company dashboards or SEO tools can now get this data directly, without manual exports and without workarounds to reconstruct it. No dates for extending this to other features, nor any country-specific limits, have been announced.

  • Branded queries: the new brandedClassification field groups or filters data between searches containing your brand and generic searches.
  • Multimodal search: setting the webMultimodal type lets you read data from Google Lens, Circle to Search on Android and image uploads.
  • Multiple countries and devices: the filterLists field lets you filter several countries or devices in the same request.

Why separating branded traffic changes how you read SEO results

People who search for your company name already know you. That traffic comes from trade fairs, word of mouth, sales agents and offline advertising: it is valuable, but it does not tell you how good your website is at being found by people who do not know you. If you mix it with everything else, a report may show growth that actually comes from a radio campaign or a trade fair.

Until now, separating the two meant using hand-written keyword lists, with variants, typos and product names. It worked poorly and needed constant updating. Now Google does the classification. Be careful, though: it only applies to eligible properties, and for the others the API returns no rows. Google does not detail the criteria here, so it is worth checking case by case before building a report on top of it.

Who do these updates really matter to?

They matter to anyone who already has some automation in place: a manufacturer exporting to several countries that wants a single dashboard for German-speaking markets, an e-commerce business comparing mobile and desktop across several countries, an agency or marketing department sending monthly reports to management. In these cases the time saved and the cleaner data are tangible.

They matter less if you have a simple brochure website with little content and check Search Console only now and then. For you, the same features are already in the interface, free and without any programming. There is no need to chase the API if you have no report to feed.

  • Exporting manufacturers: comparison by geographical area, such as DACH or Eastern European countries, in a single view.
  • Retail and e-commerce: performance of products searched for with photos or Google Lens.
  • Services and public bodies: understanding whether the site is found for the topics it covers or only by name.

Visual search with Google Lens: why measure it

More and more people search by pointing their phone at an object: a spare part, a piece of furniture, a component, an item of clothing. The webMultimodal data type tells you which pages appear in, and receive clicks from, these searches. If you sell physical products, this is information that used to stay buried.

If your company already has bulk data export to BigQuery (Google's database for large volumes) enabled, this data will arrive there too. The data alone does not improve anything: you need clear product photos, descriptive alt text and well-structured product pages. On this groundwork, SEO and GEO consulting addresses exactly the point where a website becomes readable for Google and for AI systems.

What to do now

The first step is to check in the Search Console interface whether the branded queries filter is available for your site. If it is, try comparing the two types of traffic over the last few months: the picture often looks quite different from your usual reports.

If you already have a company dashboard or automated report, ask whoever manages it to add the branded and non-branded split and the country groupings. The effort is modest for a developer who already knows the API: it is a matter of updating the requests, not rebuilding the system. If instead you want a dashboard that combines SEO, sales and CRM data, that is a broader custom dashboards and integrations project, to be assessed without rushing.

  • Check whether the branded filter is available in the interface.
  • Define which countries and devices really matter to your business.
  • Update existing reports before creating new ones.
  • Look at multimodal data only if you sell products that can be recognised from a photo.

Limits and risks to keep in mind

Brand classification is done by Google, and we do not know exactly how it handles generic brand names, product names or acronyms similar to common words. For a company whose name is also an everyday word, the result may not be perfect. It is better to spot-check a few queries before trusting it blindly.

Also, more filters mean more ways to misread the numbers. A report full of segments is not automatically useful: you need to decide first which questions you want to ask the data. If you do not know where to start, a free website check helps you understand where things stand before investing in reporting.

Frequently asked questions

What is the Search Console API?

It is the channel through which software, dashboards and SEO tools automatically read Google Search Console data, such as clicks, impressions and average position. It is useful if you want regular reports without manually exporting data from the interface.

Is the branded queries filter available for every website?

No. Google states that branded and non-branded query data is only available for eligible properties, both in the interface and in the API. For ineligible properties the API returns no rows, so it is worth checking first in the Search Console interface.

What does the webMultimodal data type measure?

It measures a website's performance in image-based searches: Google Lens, Circle to Search on Android and images uploaded to Google Search. It is particularly useful if you sell physical products that people can photograph and search for.

Want SEO reports that tell the truth?

If you want to understand how much of your traffic really comes from new customers, and in which markets, we can look at it together. Tell us how your measurement is set up today and we will start from there.

Source: New filtering and reporting capabilities in the Search Analytics API · Google Search Central, 16 November 2026

Journal

Keep reading

All articles →