Back to blog
Ad Operations

Campaign Manager 360 API Adds a Real-Time Query Endpoint — JSON Without Building a Report

Campaign Manager 360 API Adds a Real-Time Query Endpoint — JSON Without Building a Report

Google introduced a new reportData.query endpoint for the Campaign Manager 360 API, letting developers retrieve campaign performance data without generating downloadable reports. It targets real-time reporting, dashboards, and ad-hoc analysis.

What Changes

The endpoint queries campaign performance data synchronously and returns structured JSON directly in the API response.

Existing Reports APIreportData.query
SetupRequires creating a Report resourceNone
FlowRun report → poll for completion → download fileDefine dimensions, metrics, filters in the request body
ResponseCSV / Excel fileJSON returned directly
ConstraintSuited to large datasetsQueries run up to 60 seconds

The old workflow required creating a report configuration, running it, polling for completion, and downloading the generated file. Four steps collapse into one request.

The Existing API Stays

Google was explicit about where the traditional Reports service remains preferred:

  • Large datasets
  • Scheduled reporting jobs
  • Applications that rely on downloadable CSV or Excel files

This is a split by use case, not a replacement. The 60-second query ceiling makes clear the new endpoint was not designed for bulk extraction.

Where It Fits in Practice

  • Internal dashboards: eliminating report configuration and file management meaningfully reduces implementation complexity.
  • Ad-hoc analysis: query when the question arises, without predefining a report.
  • Alerting and monitoring: well suited to checking a handful of metrics on a short interval.
  • Bulk backfills: keep using the existing Reports API.

Tooling for catching gaps in ad data pipelines before they propagate is also expanding — see Google Adds a Campaign Data Import Validation Report.

The move from file-based reporting toward API-native querying is the broad direction of ad data infrastructure. Lower implementation cost does not make a dashboard useful — that is still a metric design problem.

Frequently Asked Questions

What does reportData.query change?

It removes the need to create a Report resource first. Dimensions, metrics, and filters go in the request body, and structured JSON comes back synchronously in the response.

Is there a query time limit?

Queries can run for up to 60 seconds, a limit set for interactive reporting and real-time applications.

Is the existing Reports API going away?

No. Google says the traditional Reports service remains preferred for large datasets, scheduled reporting jobs, and applications that depend on downloadable CSV or Excel files.

When should I use the new endpoint?

For internal dashboards, ad-hoc analysis, and short-interval metric monitoring. Bulk data backfills are still better served by the existing Reports API.

Where does your own site stand?

To apply what you just read to your own site, start with a free audit of where things are now.

A strategist replies within 24 hours on business days.

Read next