GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In

[Statistics] Requesting a Report

Retrieving Statistics for a Specific Advertiser

The Statistics API allows measurement and reporting on campaigns using the metrics and dimensions you specify.

https://api.criteo.com/2021-01/statistics/report
{
    "advertiserIds": "12345",
    "startDate": "2020-09-10T04:00:00.000Z",
    "endDate": "2020-09-14T04:00:00.000Z",
    "format": "csv",
    "dimensions": ["AdsetId","Day"],
    "metrics": ["Displays","Clicks"],
    "timezone": "PST",
    "currency": "USD"
}

 

A report is generated via a POST call and the results are returned directly in the response.

AdsetId,Day,Currency,Displays,Clicks
54321,2020/9/10,USD,2534,35
54321,2020/9/11,USD,6234,96
54321,2020/9/12,USD,4357,54
54321,2020/9/13,USD,3245,45
54321,2020/9/14,USD,4584,72

 

Response Codes

The following response codes may be returned by the API:

400: Bad request, invalid syntax or validation error. Review the request to make sure the format is valid.
401: Authentication failed. Ensure the authentication header is formatted properly and your access token hasn't expired.
403: No campaign found. Verify your campaign IDs are correct.
429: Throttling failure. Wait a minute to try again - there is a limit of 200 requests per minute.
500: Unknown error.

 


What’s Next

Learn about the structure of a report request