Reports - API Docs

Getting Started

Management

Campaigns

Creatives

Zones

Reports

Create a Report

post

/reports

Request Body (JSON)

date_from string, required	The start date in the format YYYY-MM-DD.
date_until string, required	The end date in the format YYYY-MM-DD.
dimensions object, required	An object containing one or more dimensions for which you wish to retrieve the data. See here below. Example: ["day","campaign_id"]

List of dimensions

The following dimensions are supported:

year
month
day
hour
weekday
hour
campaign_id
creative_id
zone_id
ad_format
ad_size
landing_url
tier
country
region
city
language
domain
device
browser

cURL

curl "https://{yourname}.api.adglare.app/v2/reports"
  -H "Content-Type: application/json"
  -H "x-api-key: {api_key}"
  -d '{
    "date_from": "2024-01-01",
    "date_until": "2024-01-02",
    "dimensions": ["day"]
  }'

Example Response

{
    "items": {
        "2024-01-01": {
            "ad_requests": 834,
            "filled_impressions": 832,
            "impressions": 415,
            "measurable_impressions": 415,
            "viewable_impressions": 161
        },
        "2024-01-02": {
            "ad_requests": 4434,
            "filled_impressions": 4432,
            "impressions": 2211,
            "measurable_impressions": 2211,
            "viewable_impressions": 1001
        }
    },
    "totals": {
        "ad_requests": 5268,
        "filled_impressions": 5264,
        "impressions": 2626,
        "measurable_impressions": 2626,
        "viewable_impressions": 1162
    }
}