/2026-01/statistics/report

This Statistics endpoint provides adset related data. It is an upgrade of our previous Statistics endpoint, and includes new metrics and customization capabilities.

Body Params
adSetIds
array of strings | null

list of adSets ids. If empty, all the adSets will be fetched

adSetIds
adSetNames
array of strings | null

list of adSets names. If empty, all the adSets will be fetched

adSetNames
adSetStatus
array of strings | null

list of adSets status. If empty, all the adSets will be fetched

adSetStatus
string | null

The comma-separated list of advertiser ids. If empty, all the advertisers in the portfolio will be used

string
required

The currency used for the report. ISO 4217 code (three-letter capitals).

dimensions
array of strings
required

The dimensions for the report.

dimensions*
date-time
required

End date of the report. Date component of ISO 8061 format, any time or timezone component is ignored.

string
enum
Defaults to json

The file format of the generated report

Allowed:
metrics
array of strings
required

The list of metrics to report.

metrics*
date-time
required

Start date of the report. Date component of ISO 8061 format, any time or timezone component is ignored.

string | null
Defaults to UTC

The timezone used for the report. Timezone Database format (Tz).

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/csv
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet