Display Ad Server
Serve ads in standard fixed-size ad units
Native Ad Server
Serve native ads on your web page or app
VAST Video Ad Server
Serve MP4 video ads as pre/mid/post-rolls
CTV Video Ad Server
Monetize your CTV channel
White Label Ad Server
Build your own ad server in hours
API Quickstart
Test the API in just minutes
Full API Docs
Automate your complete ad operations
Migration Assistance
Need help switching to AdGlare?
Management APIs
Automate your complete ad ops workflow
Realtime Reporting
Never miss an imporant KPI
Enterprise-grade Infrastructure
Engineered for speed, built for trust
Video Optimization
Built-in quality checks before going live
Feature Overview
See if we're a fit in minutes
Talk to Sales
Reach out to get started
Talk to Support
Get help with your ad server
Request a Demo
Get a free demo to see if we're a fit
Security / Compliance
GDPR / CCPA, cookie laws, ISO 27001
Terms of Service
AdGlare's terms and privacy policy
Network Status
Keep track of network uptime
☰
Getting Started
API Overview

Campaign API
Campaigns
Creatives

Inventory API
Zones
GETList Zones
POSTCreate Zones
PUTUpdate Zones
DELETEDelete Zones

Reporting API
API Overview
Real Time Reports
Data Shipping

Additional APIs
Advertisers
Workspaces
Folders
Audit Trails

Zones

Get a list of Zones

get
/zones

Query Parameters

limit
int
 The number of items returned in the response. Defaults to 100.
offset
int
 The number of items to skip before starting to return results. Defaults to 0.
Example Request
curl "https://{yourname}.api.adglare.app/v2/zones"
  -H "Authorization: Bearer {api_key}"
Example Response
{
    "items": [{
        "account_id_created": 685576430,
        "account_id_modified": 764685530,
        "ad_format": "display",
        "campaign_ids": [279481212],
        "created": 1687148279,
        "data": {
            "auto_refresh": {
                "interval": 20,
                "times": 24
            },
            "lazy_loading": false
        },
        "event_counts": {
            "ad_requests": 10230781,
            "clicks": 8214,
            "filled_impressions": 10217567,
            "impressions": 10209912,
            "measurable_impressions": 9755528,
            "unfilled_impressions": 12486,
            "viewable_impressions": 6076664
        },
        "folder_id": 796278613,
        "is_active": true,
        "metadata": [],
        "modified": 1727763923,
        "name": "Dashboard",
        "notes": "",
        "pricing": {
            "model": null,
            "value": null
        },
        "watchlist": [],
        "zone_id": 433441350
    },
    {
        "account_id_created": 645685730,
        "account_id_modified": 685764530,
        "ad_format": "display",
        "...": "..."
    }]
}

Get a single Zone

get
/zones/{id}

Path Parameters

id
int, required
 The ID of the zone.
Example Request
curl "https://{yourname}.api.adglare.app/v2/zones/{id}"
  -H "Authorization: Bearer {api_key}"
Example Response
{
    "account_id_created": 685576430,
    "account_id_modified": 764685530,
    "ad_format": "display",
    "campaign_ids": [279481212],
    "created": 1687148279,
    "data": {
        "auto_refresh": {
            "interval": 20,
            "times": 24
        },
        "lazy_loading": false
    },
    "event_counts": {
        "ad_requests": 10230781,
        "clicks": 8214,
        "filled_impressions": 10217567,
        "impressions": 10209912,
        "measurable_impressions": 9755528,
        "unfilled_impressions": 12486,
        "viewable_impressions": 6076664
    },
    "folder_id": 796278613,
    "is_active": true,
    "metadata": [],
    "modified": 1727763923,
    "name": "Dashboard",
    "notes": "",
    "pricing": {
        "model": null,
        "value": null
    },
    "watchlist": [],
    "zone_id": 433441350
}

Create a Zone

post
/zones

Request Body (JSON)

name
string, required
 The name of the zone.
folder_id
int, required
 The folder ID of the zone.
ad_format
string, required
 The ad format: display, native, vast, redirect
Example Request
curl "https://{yourname}.api.adglare.app/v2/zones"
  -X POST
  -H "Content-Type: application/json"
  -H "Authorization: Bearer {api_key}"
  -d '{
    "name": "My Zone",
    "folder_id": 123456789,
    "ad_format": "display"
  }'
Example Response
{
    "zone_id": 764306855
}

Update a Zone

put
/zones/{id}

Path Parameters

id
int, required
 The ID of the zone.

Request Body (JSON)

name
string, required
 The name of the zone.
is_active
boolean, required
 The name of the zone.
folder_id
int, required
 The folder ID in which this zone resides.
data
object, required
 An object containing the settings for this zone. See here below.

The data object

For ALL zones:
  • blocked_creatives (array): list of creative IDs that should be blocked in this zone. Example: [123456789,987654321]

For Display Ad zones:
  • ad_sizes (array): list of ad sizes that can be displayed in this zone. Example: ["300x250","970x250"]
  • auto_refresh (object): an object as in this example: {"interval":60,"times":5} (refreshes once per minute for 5 times)
  • lazy_loading (boolean): true/false

For Native Ad zones:
  • log_impression (boolean): true/false
  • max_ads (int): [1-25]

For VAST Ad zones:
  • vast_version (string): either 2.0, 3.0, 4.0, 4.1, 4.2, 4.3

Example Request
curl "https://{yourname}.api.adglare.app/v2/zones/{id}"
  -X PUT
  -H "Content-Type: application/json"
  -H "Authorization: Bearer {api_key}"
  -d '{
    "name": "My Zone",
    "folder_id": 123456789,
    "is_active": true,
    "data": {"log_impression": false,"max_ads": 1}
  }'
Example Response
{}

Delete a Zone

delete
/zones/{id}

Path Parameters

id
int, required
 The ID of the zone.
Example Request
curl "https://{yourname}.api.adglare.app/v2/zones/{id}"
  -X DELETE
  -H "Authorization: Bearer {api_key}"
Example Response
{}