Your weekly search report shows more clicks, but the team needs to know which market changed and whether people were already looking for your brand. A single site-wide total leaves both questions open.
On November 16, 2026, Google announced three additions to the Search Analytics API. Teams can use branded-query classification, retrieve web multimodal performance, and select multiple countries or devices in a request. These capabilities bring existing Search Console reporting options into automated workflows. Google’s API update announcement
The useful first step is to define one report the team will act on. The following workflow starts with a comparison between two markets and gives the analyst a clear record to reproduce.
Write the decision before the request
Suppose a software business serves Germany and Austria. The marketing team wants to know where its public integration guides are attracting interest from people who search without naming the brand. That question gives the analyst a starting scope and the editor a reason to inspect particular pages.
Agree on the properties, markets, device types and reporting period before requesting data. Keep that scope fixed in the next comparison. If a campaign launched halfway through the period, record its dates beside the chart so a later reviewer has the context.
| Reporting decision | Example to agree with the team |
|---|---|
| Business question | Which integration guides attract non-branded search interest in our two markets? |
| Page scope | The published guides the team maintains |
| Market view | Germany and Austria, displayed as separate countries |
| Device view | Mobile and desktop, with each visible in the report |
| Comparison | Two complete periods of equal length |
| Next action | Inspect a relevant page and its search context before assigning an edit |
This is an illustrative reporting brief. Choose markets and pages that match your own business.
AI already decides how your brand shows up.
Every prompt, citation, and recommendation is a signal. igeo.ai turns that behavior into clear answers and the next action, whether that’s a page to rewrite, a schema to add, or a story to publish.
Map the brief to the supported fields
The API uses brandedClassification with BRANDED and NON_BRANDED values. Classification is available for eligible top-level properties with sufficient volume. A request that groups or filters by classification cannot also include a query filter.
Use filterLists for a selection of countries or devices. Country values use three-letter codes, and device values include MOBILE and DESKTOP. If you want distinct country rows, include country as a grouping dimension as well as selecting it in the filter. Keep each dimension in one filtering mechanism within a request.
For visual-search analysis, type: webMultimodal covers Lens, Circle to Search on Android and image uploads in Google Search. Plan that as a named report with its own purpose, such as reviewing pages that explain visually identifiable products. Google’s Search Analytics query reference
Have the analyst save the request settings with the export. A chart titled “Non-branded mobile clicks in Germany” should have enough detail attached for another person to recreate it.
Check an empty result before charting it
If a classification request returns no rows, first check eligibility and whether the same property and dates return data in a simpler request. Google says ineligible properties return no rows for the new classification option. Also check pagination, since an offset beyond the available results returns an empty response. The API prioritizes top rows within its data limits. Google’s feature availability notes and query reference
Label a missing segment as unavailable until you have established what the response means. Keep the request, response status and investigation together. That record helps the next analyst tell a collection issue from a real change.
Turn the report into one page investigation
Choose a page that matters commercially and inspect the country and device breakdown. Compare its title, explanation and next step with the audience it serves. If the page discusses an integration but omits the setup requirements customers keep asking about, assign that concrete addition and record when it goes live.
Use igeo.ai AI Traffic Analytics to bring available search-performance signals alongside identifiable AI referral and crawler activity. Review which fields your connected reporting exposes when planning the workflow. The new Google API options are documented capabilities of Google’s interface.
For a wider view of how buyer questions lead to content work, see our AI search competitor analysis guide. Bring one market-reporting question and a page your team maintains to an igeo.ai demo to explore how the available evidence can guide your next edit.