Get row-level data
post
/data-shipping
Request Body (JSON)
| date string, required |
The date in the format YYYY-MM-DD. |
| events array |
An array containing the events you want to filter for in the row-level logs. See here below. Example: ["impressions","clicks"] |
As row-level logs can containg gigabytes of data, the API response will return a url from where you can download the CSV file. Note that this file is zipped.
If you need row-level logs across multiple days, simply iterate over the days and then merge the files afterward.
The events array
The following events are supported:
- ad_requests
- impressions
- clicks
- redirects
- conversions
- conversion_value
- value
- filled_impressions
- unfilled_impressions
- viewable_impressions
- measurable_impressions
- vast_skipped
- vast_skippable
- vast_started
- vast_q1
- vast_q2
- vast_q3
- vast_completed
Example Request
curl "https://{yourname}.api.adglare.app/v2/data-shipping"
-X POST
-H "Content-Type: application/json"
-H "Authorization: Bearer {api_key}"
-d '{
"date": "2025-12-07",
"events": ["clicks"]
}'
-X POST
-H "Content-Type: application/json"
-H "Authorization: Bearer {api_key}"
-d '{
"date": "2025-12-07",
"events": ["clicks"]
}'
Example Response