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.
    "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.



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