Digital Marketing · 18 November 2026

How to Use the New Branded‑Query API to Guard Your Brand in Search

Google’s Search Console API now returns a brandedClassification field. Use it to spot brand‑related search spikes, protect visibility and fine‑tune SEO spend.

Google announced that the Search Console Performance report features are now available in the Search Analytics API. The addition includes a brandedClassification dimension that returns BRANDED or NON_BRANDED for each query, plus new filters for multiple countries or devices in a single request.

Why it matters: the API lets you pull branded‑search data directly into your dashboards or monitoring tools, removing the need to stitch together separate queries or maintain complex regex lists. For any brand, spotting unexpected drops or spikes in branded traffic is the first step to defending against competitor hijacking, negative SEO, or algorithm shifts.

What the API actually delivers

  • A brandedClassification field that can be filtered or grouped using the equals operator; values are BRANDED or NON_BRANDED.
  • Data is only available for top‑level properties and starts on Feb 21 2026; properties that don’t meet the query‑impression threshold return an empty table.
  • A filterLists parameter that lets you request results for several countries or device types in one call (e.g., IN, US or mobile, desktop).

How to incorporate the data into your workflow

1. Add the brandedClassification dimension to your existing Search Console API calls. Because the API only accepts the equals operator, you’ll need two separate requests—one for BRANDED and one for NON_BRANDED—if you want both sets side‑by‑side.

2. Combine the new filterLists field with your country/device selections. For a brand with an international audience you might request IN plus US to compare domestic versus overseas interest without issuing multiple calls.

3. Store the results in a data warehouse or BI tool.

4. Set up alerts. Compare today’s branded impressions and clicks against a rolling 7‑day average; a sudden dip could signal a technical issue or a competitor’s SEO attack, while a spike may indicate a successful campaign or emerging brand‑related queries.

Practical steps for any business

  • Create a simple script (Python, Node, etc.) that pulls BRANDED data for your primary property each morning.
  • Overlay the branded trend on your overall traffic chart to see the proportion of brand‑related searches.
  • If branded impressions fall noticeably below recent averages, trigger a review of your on‑page SEO, sitemap, and any recent site changes.
  • Use the country filterLists to monitor branded searches from IN versus US or UK to detect cross‑border brand misuse.

What to do now

Start by adding the brandedClassification dimension to your existing Search Console API integration. Run a test pull for the past week to confirm you receive rows; if the table is empty, verify that your property meets the query‑impression minimum. Once you have data, build a basic dashboard that shows daily branded impressions, clicks and average position. Set a simple alert for any day where branded impressions drop sharply from the recent mean. From there, you can investigate the cause—whether it’s a technical glitch, a content change, or a competitor’s backlink activity—and adjust your SEO strategy accordingly.

Put this to work

The services behind this post.

More from the blog

FAQ

Frequently asked questions.

No. The API only tracks brandedClassification from Feb 21 2026 onward. Earlier periods will return an empty table, as the source explains.

Next step

Talk to the team that does this every day.

Tell us what you're trying to grow. You'll get a plan, not a pitch.

Contact Us