Get reporting data

GET 
/ad-publishing/google/reporting

Retrieve aggregated Google Ads reporting metrics for a location

Request

Version stringrequired

API Version

Available optionsv3

locationId stringrequired

Location identifier

fields string[]required

Reporting fields. Pass as comma-separated values on the wire (e.g. ?fields=impressions,clicks).

Available optionsimpressionsclickscost_microsaverage_cpcconversionsaverage_cpmcost_per_conversionctr

groupBy string

Group by period

Available optionsdateweekmonth

startDate stringrequired

Report start date

endDate stringrequired

Report end date

type stringrequired

Integration type

Available optionsAD_MANAGERINTEGRATION

application/json

Metrics grouped by the requested interval, plus totals. Only the requested fields appear.

application/json

Schema

Schema

groupedobject[]required

One entry per time bucket

totalsobjectrequired

Metrics summed across every bucket

Example (auto)

{
  "grouped": [
    {
      "segments": {
        "week": "2026-08-03"
      },
      "metrics": {
        "impressions": 6041,
        "clicks": 180,
        "costMicros": 5421341,
        "averageCpc": 864547.05,
        "conversions": 0,
        "averageCpm": 25877259.57,
        "costPerConversion": 0,
        "ctr": 0.115
      }
    }
  ],
  "totals": {
    "impressions": 6041,
    "clicks": 180,
    "costMicros": 5421341,
    "averageCpc": 864547.05,
    "conversions": 0,
    "averageCpm": 25877259.57,
    "costPerConversion": 0,
    "ctr": 0.115
  }
}