Facebook ReportingVersion: v3

Get campaign reporting

GET/ad-publishing/facebook/reporting/campaign/{campaignId}

Retrieve reporting for one campaign as a flat object, not the { grouped, totals } envelope the account-level report uses. Merges the locally stored campaign, Meta insights for the window, and CDP-attributed contacts. The campaign must be published — one without an fbCampaignId is rejected. Note results.lead (Meta lead actions) and leads (CDP attributed contacts) measure different things and routinely disagree.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly

Auth methods:OAuthPrivate Integration

Token type:Sub-Account Token

Request

Headers

Versionstringrequired

API Version

Available optionsv3

Example:v3

Path Parameters

campaignIdstringrequired

Campaign identifier

Example:507f1f77bcf86cd799439011

Query Parameters

locationIdstringrequired

Location identifier

Example:fRMewNQIxSyZ5R4nQyit

startDatestringrequired

Report start date (YYYY-MM-DD)

Example:2022-01-11

endDatestringrequired

Report end date (YYYY-MM-DD)

Example:2022-01-31

Response

application/json

Campaign metadata, Meta insights, and attributed contacts for the window

_idstringrequired

Campaign id in this service. Note _id, not id.

Example:6890a65597bae1febe1581d1

namestringrequired

Campaign name

Example:Do not touch - Lead Form Campaign

objectivestringrequired

Campaign objective

Example:OUTCOME_LEADS

publishingStatusstringrequired

Local publishing status

Example:PAUSED

fbCampaignIdstringrequired

Meta campaign id. Required — an unpublished campaign is rejected.

Example:120229485769880122

campaignIdstring

Meta campaign id, repeated from the insights row

Example:120229485769880122

startTimestring

When the campaign started, in Meta timestamp format with a numeric offset rather than UTC

Example:2025-08-04T05:24:01-0700

stopTimestring

When the campaign is scheduled to stop. Absent on open-ended campaigns.

Example:2026-09-01T00:00:00-0700

dateStartstring

First day of the reported window

Example:2025-08-01

dateStopstring

Last day of the reported window

Example:2026-08-19

clicksstring

Clicks

Example:32

cpcstring

Cost per click

Example:0.03625

ctrstring

Click-through rate as a percentage

Example:1.440792

cpmstring

Cost per thousand impressions

Example:0.522287

impressionsstring

Impressions

Example:2221

spendstring

Spend

Example:1.16

reachstring

Unique people reached

Example:2214

frequencystring

Average impressions per person reached

Example:1.003162

conversionsstring

Lead actions Meta recorded. A string here, unlike the account-level report where the same figure is a number.

Example:5

costPerConversionstring

Spend divided by lead actions

Example:0.232

resultsobject

Counts per Meta action type. Values are strings, and the types overlap so summing them double-counts.

costPerResultstring

Spend divided by the double-counted results total, so usually far smaller than the real cost per lead

Example:0.01

costPerResultBreakdownobject

Cost per action, per action type, at four decimals

leadsstring

Contacts the CDP attributed to this campaign. A different measurement from results.lead, which counts Meta lead actions — expect the two to differ.

Example:4