The API accesses properties for which the caller has the required rights. It does not expose a competitor’s private data or guarantee exhaustive exports.
Retain the query context
Record property, dates, search type, dimensions, filters and data state. Search Analytics returns rows subject to internal limits, favouring top rows; paging through results does not restore omitted rows. Do not blindly add differently grouped results.
| Point | Check to document |
|---|---|
| Query | Retained property, period, dimensions and filters |
| Result | Explicit limits and omitted-data caveats |
| Inspection | Indexed state distinct from a live test |
Separate analysis and inspection
The URL Inspection API describes the version known in Google’s index; it does not perform the interface’s live test. An API response does not automatically trigger indexing or prove Google has processed a local correction.
Sources and review
Interpret the extract before automating the dashboard
The Search Analytics API returns rows grouped by requested dimensions and filters. Its documentation says it does not guarantee every row and returns leading results; an extract is therefore not automatically the complete set of queries.
- Record property, period, search type, dimensions, filters and report time zone.
- Check totals and coverage before comparing pages or countries.
- Show sampling limits in the dashboard and revisit interpretations after a method change.
Primary reference: Google Search Console API — Search Analytics query. Related method: read the practical guide.