Get reporting data

GET 
/ad-publishing/facebook/reporting

Retrieve aggregated Facebook ad reporting metrics for a location. grouped holds one row per groupBy period, or a single row covering the whole range when groupBy is omitted, and totals aggregates across them. Both objects only carry the metrics named in fields. Be aware that ratio metrics (cpm, ctr, frequency) are summed rather than weighted in totals, and that cost_per_conversion and cost_per_result are placeholders that always read 0 — their real values live under costPerConversion and costPerResult.

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 optionsimpressionsclicksspendcpccost_per_conversionconversionsresultscost_per_resultcpmreachfrequencyctr

groupBy string

Time grouping interval

Available optionsdayweekmonth

startDate stringrequired

Report start date (YYYY-MM-DD)

endDate stringrequired

Report end date (YYYY-MM-DD)

type stringrequired

Integration source type

Available optionsAD_MANAGERINTEGRATION

application/json

Per-period rows and their aggregate totals

application/json

Schema

Schema

groupedobject[]required

One row per period when groupBy is given, otherwise a single row covering the whole range.

totalsobjectrequired

Aggregates across every row in grouped

Example (auto)

{
  "grouped": [
    {
      "dateStart": "2026-03-01",
      "dateStop": "2026-03-31",
      "locationId": "fRMewNQIxSyZ5R4nQyit",
      "accountId": "act_357046700569338",
      "impressions": "99873",
      "clicks": "2304",
      "spend": "41.47",
      "cpc": "0.017999",
      "cpm": "0.415227",
      "ctr": "2.413273",
      "reach": "650",
      "frequency": "1.02",
      "conversions": 61,
      "results": {
        "lead": 61,
        "linkClick": 1940,
        "onsiteConversion.leadGrouped": 61
      },
      "costPerConversion": 0.679836,
      "costPerResultBreakdown": {
        "lead": 0.679836,
        "linkClick": 0.021376
      }
    }
  ],
  "totals": {
    "impressions": "298574.00",
    "clicks": "5150.00",
    "spend": "115.94",
    "cpc": "0.02",
    "cpm": "96.04",
    "ctr": "4.21",
    "reach": "650.00",
    "frequency": "1.02",
    "conversions": "255.00",
    "cost_per_conversion": 0,
    "costPerConversion": "0.45",
    "results": "34315.00",
    "resultsBreakdown": {
      "lead": "255",
      "linkClick": "4236"
    },
    "cost_per_result": 0,
    "costPerResult": "0.00",
    "costPerResultBreakdown": {
      "lead": "0.4391",
      "linkClick": "0.0273"
    }
  }
}