Creatives - API Docs

Get a list of Creatives

get

/campaigns/{id}/creatives

Path Parameters

id

int, required

The ID of the campaign.

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/campaigns/{id}/creatives"
-H "Content-Type: application/json"
-H "x-api-key: {api_key}"

Example Response

{
    "items": [{
        "account_id_created": 123456789,
        "account_id_modified": 123456789,
        "ad_type": "video",
        "campaign_id": 862599431,
        "created": 1757664027,
        "creative_id": 210267475,
        "data": {
            "filehash": "abcde_s8w826w9.mp4",
            "height": 1080,
            "landing_page": "",
            "target_window": "_blank",
            "use_iframe": true,
            "width": 1920
        },
        "delivery": {
            "end": 0,
            "start": 1757664027
        },
        "event_counts": [],
        "is_active": true,
        "metadata": [],
        "modified": 1757664039,
        "name": "video.mp4",
        "targeting": [],
        "thumbnail": {
            "average_color": "#6f696e",
            "filehash": "abcde_fvg6dxwn.jpg"
        },
        "weight": 60
    }
}

Get a single Creative

get

/campaigns/{id}/creatives/{id}

Path Parameters

id int, required	The ID of the campaign.
id int, required	The ID of the creative.

Example Request

curl "https://{yourname}.api.adglare.app/v2/campaigns/{id}/creatives/{id}"
-H "Content-Type: application/json"
-H "x-api-key: {api_key}"

Example Response

{
    "account_id_created": 123456789,
    "account_id_modified": 123456789,
    "ad_type": "video",
    "campaign_id": 862599431,
    "created": 1757664027,
    "creative_id": 210267475,
    "data": {
        "filehash": "abcde_s8w826w9.mp4",
        "height": 1080,
        "landing_page": "",
        "target_window": "_blank",
        "use_iframe": true,
        "width": 1920
    },
    "delivery": {
        "end": 0,
        "start": 1757664027
    },
    "event_counts": [],
    "is_active": true,
    "metadata": [],
    "modified": 1757664039,
    "name": "video.mp4",
    "targeting": [],
    "thumbnail": {
        "average_color": "#6f696e",
        "filehash": "abcde_fvg6dxwn.jpg"
    },
    "weight": 60
}

Add a Creative

post

/campaigns/{id}/creatives

Path Parameters

id

int, required

The ID of the campaign.

Request Body (JSON)

name string, required	The name of the campaign.
ad_type int, required	The ad type. See the table here below.

List of ad types

For Display Ad campaigns:

image
code
video
zip
external

For Native Ad campaigns:

json

For VAST Video Ad campaigns:

video
url
wrapper

For Redirect Ad campaigns:

url

Example Request

curl "https://{yourname}.api.adglare.app/v2/campaigns/{id}/creatives"
  -X POST
  -H "Content-Type: application/json"
  -H "x-api-key: {api_key}"
  -d '{
    "name": "My Creative",
    "ad_type": "image",
  }'

Example Response

{
"creative_id": 685576430
}

Delete a Creative

delete

/campaign/{id}/creatives/{id}

Path Parameters

id int, required	The ID of the campaign.
id int, required	The ID of the creative.

Example Request

curl "https://{yourname}.api.adglare.app/v2/campaign/{id}/creatives/{id}"
-X DELETE
-H "x-api-key: {api_key}"

Example Response

{}