Retrieve a flexible publisher performance report by specifying the fields, filters, and grouping you need. The date range must not exceed 32 days.

Response flow

This endpoint uses a redirect pattern:

The endpoint returns 303 See Other with a Location header containing a download URL.
Follow the redirect (most HTTP clients do this automatically) to download the report data as CSV.

📘
Most HTTP clients (including curl, Postman, and browser-based code) follow the redirect automatically, so you will typically receive the CSV response directly.

Required headers

Header	Value
`Authorization`	`Bearer <access_token>`
`Accept`	`text/csv`

Query parameters

Parameter	Required	Description	Format
`requestedFields`	Yes	Comma-separated list of fields to include in results	`string`
`startInclusive`	Yes	Start of the date range (inclusive)	`YYYY-MM-DDThh:mm:ssZ`
`endExclusive`	Yes	End of the date range (exclusive)	`YYYY-MM-DDThh:mm:ssZ`
`filter`	No	Key-value filter pairs	`filter[FieldName]=value`
`groupBy`	No	Comma-separated list of fields to group results by	`string`

📘
All groupBy fields must also be included in requestedFields.

❗️
Date range limit
The time window between startInclusive and endExclusive must not exceed 32 days.

Available fields

Dimension fields (groupable and filterable):

Field	Description	Format
`DateTime`	The date/time of the record	`datetime`
`Day`	The day of the record	`datetime`
`PlacementId`	The placement ID	`integer`
`ContainerId`	The container ID	`integer`
`PublisherAccountId`	The publisher account ID	`integer`
`PublisherCompanyId`	The publisher company ID	`integer`
`DeviceOrProxy`	The device or proxy type	`string`

Metric fields (aggregatable, not groupable):

Field	Description	Format
`ServedAds`	The total number of served ads	`integer`
`Opens`	The total number of opens	`integer`
`Clicks`	The total number of clicks	`integer`
`Revenue`	The total revenue	`float`

📘
Opens behavior
When grouped by PlacementId, the Opens field reports placement-level opens. Otherwise, it reports container-level opens.

Example request

GET /reporting/publisherperformance?requestedFields=DateTime,PlacementId,ContainerId,Opens,Clicks,Revenue&startInclusive=2026-03-01T00:00:00Z&endExclusive=2026-04-01T00:00:00Z&groupBy=DateTime,PlacementId,ContainerId&filter[PlacementId]=152&api-version=1.0
Accept: text/csv
Authorization: Bearer <access_token>

Example response

The CSV returned after following the redirect:

"DateTime","PlacementId","ContainerId","Opens","Clicks","Revenue"
"2026-03-01T00:00:00Z",152,300,4820,312,148.50
"2026-03-02T00:00:00Z",152,300,3210,198,96.30