Search Console API adds branded and Google Lens data

Google's Search Analytics API can now split branded from non-branded searches and report Google Lens traffic. Here is what local businesses should do.

SEOchat News Desk · ·

Share

Google has opened up three Search Console reports to automation. In a Search Central blog post on November 16, the Search Console team said the Search Analytics API now supports the branded queries filter, reporting for web multimodal search, and filters that cover several countries or devices in one request. All three were already in the Search Console Performance report. What is new is that software, dashboards, and reporting tools can now pull the same data on a schedule without anyone clicking through the interface.

That sounds like a developer story, and partly it is. But for a local business the branded filter answers a question owners ask all the time: are new customers finding us on Google, or only people who already know our name?

What changed

According to Google's announcement, the API gains three options:

  • Branded queries. Data can be grouped or filtered by a new brandedClassification dimension to compare branded and non-branded performance. Google says this works only for eligible properties, and other properties get no rows back.
  • Web multimodal. Setting the search type to webMultimodal returns performance data from Google Lens, Circle to Search on Android, and image uploads in Google Search.
  • Multi-country and multi-device filters. A new filterLists field lets one request cover several countries or devices at once.

Google's stated reason is simple: people asked for it. The post says the team brought the features to the API "following ecosystem requests to make this data available for custom reporting and automated workflows." It also says the filters can be combined, so a report could, for example, look at branded traffic on mobile phones across a group of countries.

The details that matter

The Search Analytics API reference adds a few limits that are worth knowing before you or your marketing vendor build anything on top of this.

Branded data starts on February 21, 2026, so you cannot use it to look back further than that. It is available only for top-level properties with enough query and impression volume. The reference also says that filtering or grouping by brand cannot be combined with a filter on the query text in the same request, and the brand filter accepts only two values: branded and non-branded.

That eligibility rule is the catch for small businesses. When Google first launched the branded filter inside Search Console, its original announcement said it was not available for URL path properties, such as a single folder of a site, or for subdomain properties, and that a site needed a sufficient volume of queries and impressions. A newer shop with modest search traffic may simply see nothing. Google's API post confirms that in that case the response will contain no rows, not an error.

It also helps to know how Google decides what counts as a brand search. The same announcement explains that the split is made by an internal, AI-assisted system rather than a keyword list. It covers your brand name in all languages, misspellings, and searches for products or services unique to your site even when the name is missing. Google warns that some searches may occasionally be misclassified, and says the filter has no effect on rankings.

Why the branded split matters for a local business

Branded searches come from people who already know you: a past patient looking up your dental office's phone number, or a homeowner who saw your truck and typed your company name. Those searches matter, but they mostly reflect word of mouth, ads, and reputation you have already earned.

Non-branded searches are different. These are people typing things like "emergency plumber near me" or "roof leak repair" who have never heard of you. Google's own announcement describes non-branded queries as the ones that show organic growth, because they reveal how new users find your content without first intending to visit your site.

If your total Google clicks go up, it is fair to ask why. If most of the gain is branded, your SEO may not be what is working; your reviews, referrals, or advertising might be. If non-branded clicks are rising, your pages are starting to win searches from strangers, which is the growth most owners are paying for.

With the API, that split can now land in a weekly report automatically instead of depending on someone remembering to open Search Console and set the filter by hand.

Why the Lens data matters

The multimodal data covers searches that start with an image rather than typed words. Google lists three sources: Google Lens, Circle to Search on Android, and image uploads in Google Search. Google's post does not break down what kinds of searches these are, so treat it as a new signal to watch rather than a channel with known behavior.

For businesses whose customers often search with a camera, such as a landscaper, an auto repair shop, or a boutique, it is worth checking whether any traffic shows up here at all. Having that number in a regular report makes it easier to notice if it starts to grow.

What to do now

This section is our guidance, not Google's.

  • Confirm you have the right property. The branded filter needs a top-level property. If your Search Console account only has a URL path property for one folder of your site, ask whoever manages it whether a domain-level property can be added.
  • Ask your reporting vendor about it. If an agency or tool sends you monthly SEO reports, ask whether it will add the branded and non-branded split. It is now a standard API feature, not a manual export.
  • Judge SEO by non-branded growth. When you review results, look at non-branded clicks first. That is the clearest sign that new people are finding you through search.
  • Grow the branded side too. Reviews and a complete Google Business Profile help people who heard about you find and trust you. Our guide to getting more Google reviews and the free review link generator can help.
  • Keep the core update in mind. Google's November core update is still rolling out, so any before-and-after comparison this month will be noisy. Our story on reading your traffic during the update explains how to compare fairly.

For a dentist, plumber, or roofer, the most useful number in this release is the share of Google clicks that come from people who did not already know your name. Now that it is in the API, it can be tracked every week without extra work.

Sources

For your business

Related stories