1. Authorization

1.1. Login

This `POST` request will return result login and token

1.1.1. Request Body

Path Type Description Required

email

string

User email

+

password

string

User password

+

1.1.2. HTTP Request

URL

POST api/users/login HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
DATA
{
    "email": "test@example.org",
    "password": "password"
}

1.1.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/users/login' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
    -d '{
    "email": "test@example.org",
    "password": "password"
}'

1.1.4. Response Body

Path Type Description

access_token

string

This token is used in queries. HEADER: "Authorization: Bearer <this token>"

token_type

string

Token type

expires_in

int

Time token live in seconds

1.1.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    X-ratelimit-limit: 10
    X-ratelimit-remaining: 9
    Access-control-allow-origin: *
{
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMvYXBpL3VzZXJzL2xvZ2luIiwiaWF0IjoxNzQyOTgyODE2LCJleHAiOjE3NDI5ODY0MTYsIm5iZiI6MTc0Mjk4MjgxNiwianRpIjoiMUlEYkJxemNTdTFoTXo4YSIsInN1YiI6IjciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.i8oeZcF6_L-nK-ayLpEaaZjcZbGXkAETJna9RzB9VeE",
    "token_type": "bearer",
    "expires_in": "60"
}

1.2. Log out

A `POST` request will return result logout

1.2.1. HTTP Request

URL

POST api/logout HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJzTzRtRGZGMm04S3Z6UjBEIiwic3ViIjoiOCIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.IwJ6SEmvtYOJeAKafSRkF4Wskea97jqf5A0j1E24k6U
DATA
{}

1.2.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/logout' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJzTzRtRGZGMm04S3Z6UjBEIiwic3ViIjoiOCIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.IwJ6SEmvtYOJeAKafSRkF4Wskea97jqf5A0j1E24k6U' \
    -d '{}'

1.2.3. Response Body

Path Type Description

message

string

Result message

1.2.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
{
    "message": "Successfully logged out"
}

2. Statistic

2.1. Statistic

A `POST` request will return statistic.

2.1.1. Request Body

Path Type Description Required

timezone

integer

Timezone
"Etc/GMT+12"…​"Etc/GMT+1", "Etc/GMT", "Etc/GMT-1"…​"Etc/GMT-12" \n"America/Anchorage"…​"Europe/Istanbul", "Asia/Tokyo"

from

date

Start date (yyyy-mm-dd)

+

to

date

End date (yyyy-mm-dd)

+

groupBy

array

Grouping fields:
YMD - Date
YMDH - Date time. Period: 2 days max
campaignId - Campaign
creativeId - Creative
country - Country
connectionType - Connection Type
carrier - Carrier
sspId - Ssp
region - Region
city - City
browser - Browser
os - Device OS
appName - App Name
siteName - Domain Name
source - Source
originalPubId - Publisher Id
sitePage - Site Page
trafficType - Media Type
requestType - Traffic Type
deviceType - Mobile Type
language - Language
size - Width x Height
isPmpReq - Pmp

+

agregatedFields

array

Agregated fields:
bids - Bids
wins - Wins
impressions - Impressions
clicks - Clicks
conversions - Conversions
reach - Reach
dspSpend - Spend
ecpm - eCPM
ecpc - eCPC
ctr - CTR
winrate - Win Rate

+

orderField

string

Sorting field

orderDir

string

Sort order: "asc" or "desc"

page

integer

Pagination: page number

rowsOnPage

integer

Pagination: rows on page (min:10, max:50000)

2.1.2. HTTP Request

URL

POST api/statistic HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJJUTQ0Y3piUG5OdTlYa3VoIiwic3ViIjoiNTEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ivDAwLcPss17ZvmrhImJzZN5hWzYGaWSslz0a5neFMU
DATA
{
    "timezone": "Etc\/GMT+10",
    "from": "2025-03-24",
    "to": "2025-03-26",
    "groupBy": [
        "YMD",
        "campaignId",
        "creativeId"
    ],
    "agregatedFields": [
        "bids",
        "wins",
        "impressions",
        "clicks",
        "dspSpend",
        "winrate",
        "ctr"
    ],
    "orderField": "YMD",
    "orderDir": "desc",
    "page": 1,
    "rowsOnPage": 25
}

2.1.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/statistic' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJJUTQ0Y3piUG5OdTlYa3VoIiwic3ViIjoiNTEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ivDAwLcPss17ZvmrhImJzZN5hWzYGaWSslz0a5neFMU' \
    -d '{
    "timezone": "Etc\/GMT+10",
    "from": "2025-03-24",
    "to": "2025-03-26",
    "groupBy": [
        "YMD",
        "campaignId",
        "creativeId"
    ],
    "agregatedFields": [
        "bids",
        "wins",
        "impressions",
        "clicks",
        "dspSpend",
        "winrate",
        "ctr"
    ],
    "orderField": "YMD",
    "orderDir": "desc",
    "page": 1,
    "rowsOnPage": 25
}'

2.1.4. Response Body

Path Type Description

status

string

Report status

data.*.YMD

date

Date

data.*.campaignId

integer

Campaign id

data.*.campaignId_dict

string

Campaign name

data.*.creativeId

integer

Creative id

data.*.creativeId_dict

string

Creative name

data.*.bids

integer

Bids

data.*.wins

integer

Wins

data.*.impressions

integer

Impressions

data.*.dspSpend

float

Spend, $

data.*.winrate

float

Win Rate, %

data.*.ecpm

integer

eCPM, $

data.*.clicks

integer

Clicks

data.*.conversions

integer

Conversions

data.*.ctr

float

CTR, %

totals.YMD

date

Date

totals.campaignId

integer

Campaign id

totals.campaignId_dict

string

Campaign name

totals.creativeId

integer

Creative id

totals.creativeId_dict

string

Creative name

totals.bids

integer

Bids

totals.wins

integer

Wins

totals.impressions

integer

Impressions

totals.dspSpend

float

Spend, $

totals.winrate

float

Win Rate, %

totals.ecpm

integer

eCPM, $

totals.clicks

integer

Clicks

totals.conversions

integer

Conversions

totals.ctr

float

CTR, %

pagination.page

integer

Pagination: current page number

pagination.per_page

integer

Pagination: items per page

pagination.total

integer

Pagination: total items count

2.1.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "status": "success",
    "data": [
        {
            "YMD": "2025-03-26",
            "campaignId": 1,
            "campaignId_dict": "Et et| id# 1",
            "creativeId": 12,
            "creativeId_dict": "Alias id| id# 12",
            "bids": 843,
            "wins": 506,
            "impressions": 415,
            "dspSpend": 0.42523,
            "winrate": 60.02372479240807,
            "ecpm": 1.0246506024096387,
            "clicks": 28,
            "conversions": 43,
            "ctr": 6.746987951807229
        },
        {
            "YMD": "2025-03-26",
            "campaignId": 2,
            "campaignId_dict": "Qui molestiae| id# 2",
            "creativeId": 11,
            "creativeId_dict": "Esse necessitatibus| id# 11",
            "bids": 360,
            "wins": 199,
            "impressions": 158,
            "dspSpend": 0.30794,
            "winrate": 55.27777777777778,
            "ecpm": 1.948987341772152,
            "clicks": 47,
            "conversions": 38,
            "ctr": 29.746835443037973
        },
        {
            "YMD": "2025-03-26",
            "campaignId": 2,
            "campaignId_dict": "In pariatur| id# 2",
            "creativeId": 12,
            "creativeId_dict": "Occaecati labore| id# 12",
            "bids": 837,
            "wins": 397,
            "impressions": 328,
            "dspSpend": 0.377,
            "winrate": 47.43130227001195,
            "ecpm": 1.149390243902439,
            "clicks": 49,
            "conversions": 16,
            "ctr": 14.939024390243903
        },
        {
            "YMD": "2025-03-25",
            "campaignId": 1,
            "campaignId_dict": "Illo voluptatum| id# 1",
            "creativeId": 11,
            "creativeId_dict": "Optio aut| id# 11",
            "bids": 377,
            "wins": 217,
            "impressions": 177,
            "dspSpend": 0.40638,
            "winrate": 57.55968169761273,
            "ecpm": 2.2959322033898304,
            "clicks": 3,
            "conversions": 1,
            "ctr": 1.694915254237288
        },
        {
            "YMD": "2025-03-26",
            "campaignId": 1,
            "campaignId_dict": "Est rerum| id# 1",
            "creativeId": 11,
            "creativeId_dict": "Pariatur hic| id# 11",
            "bids": 959,
            "wins": 405,
            "impressions": 305,
            "dspSpend": 0.30338,
            "winrate": 42.231491136600624,
            "ecpm": 0.9946885245901639,
            "clicks": 18,
            "conversions": 47,
            "ctr": 5.901639344262295
        },
        {
            "YMD": "2025-03-25",
            "campaignId": 1,
            "campaignId_dict": "Ut sapiente| id# 1",
            "creativeId": 12,
            "creativeId_dict": "Omnis perspiciatis| id# 12",
            "bids": 783,
            "wins": 283,
            "impressions": 198,
            "dspSpend": 0.44606,
            "winrate": 36.14303959131545,
            "ecpm": 2.2528282828282826,
            "clicks": 38,
            "conversions": 5,
            "ctr": 19.19191919191919
        },
        {
            "YMD": "2025-03-25",
            "campaignId": 2,
            "campaignId_dict": "Consectetur amet| id# 2",
            "creativeId": 11,
            "creativeId_dict": "Ea dolorum| id# 11",
            "bids": 195,
            "wins": 84,
            "impressions": 58,
            "dspSpend": 0.47896,
            "winrate": 43.07692307692308,
            "ecpm": 8.257931034482759,
            "clicks": 4,
            "conversions": 36,
            "ctr": 6.896551724137931
        },
        {
            "YMD": "2025-03-25",
            "campaignId": 2,
            "campaignId_dict": "Provident magnam| id# 2",
            "creativeId": 12,
            "creativeId_dict": "Totam ab| id# 12",
            "bids": 432,
            "wins": 149,
            "impressions": 111,
            "dspSpend": 0.36306,
            "winrate": 34.49074074074074,
            "ecpm": 3.270810810810811,
            "clicks": 19,
            "conversions": 39,
            "ctr": 17.117117117117118
        },
        {
            "YMD": "2025-03-24",
            "campaignId": 1,
            "campaignId_dict": "Non omnis| id# 1",
            "creativeId": 11,
            "creativeId_dict": "Quia quas| id# 11",
            "bids": 227,
            "wins": 83,
            "impressions": 67,
            "dspSpend": 0.4211,
            "winrate": 36.563876651982376,
            "ecpm": 6.285074626865671,
            "clicks": 29,
            "conversions": 32,
            "ctr": 43.28358208955224
        },
        {
            "YMD": "2025-03-24",
            "campaignId": 1,
            "campaignId_dict": "Explicabo error| id# 1",
            "creativeId": 12,
            "creativeId_dict": "A natus| id# 12",
            "bids": 622,
            "wins": 324,
            "impressions": 289,
            "dspSpend": 0.28777,
            "winrate": 52.09003215434084,
            "ecpm": 0.9957439446366784,
            "clicks": 13,
            "conversions": 14,
            "ctr": 4.498269896193771
        },
        {
            "YMD": "2025-03-24",
            "campaignId": 2,
            "campaignId_dict": "Culpa consectetur| id# 2",
            "creativeId": 11,
            "creativeId_dict": "Est voluptate| id# 11",
            "bids": 539,
            "wins": 327,
            "impressions": 266,
            "dspSpend": 0.37842,
            "winrate": 60.667903525046384,
            "ecpm": 1.4226315789473682,
            "clicks": 31,
            "conversions": 6,
            "ctr": 11.654135338345865
        },
        {
            "YMD": "2025-03-24",
            "campaignId": 2,
            "campaignId_dict": "Et ullam| id# 2",
            "creativeId": 12,
            "creativeId_dict": "Ut commodi| id# 12",
            "bids": 493,
            "wins": 312,
            "impressions": 230,
            "dspSpend": 0.41912,
            "winrate": 63.28600405679513,
            "ecpm": 1.8222608695652174,
            "clicks": 25,
            "conversions": 50,
            "ctr": 10.869565217391305
        }
    ],
    "totals": {
        "YMD": "",
        "campaignId": 0,
        "campaignId_dict": "",
        "creativeId": 0,
        "creativeId_dict": "",
        "bids": 6667,
        "wins": 3286,
        "impressions": 2602,
        "dspSpend": 4.61442,
        "winrate": 49.0702081226296,
        "ecpm": 2.6434108386834176,
        "clicks": 304,
        "conversions": 327,
        "ctr": 14.378378579853843
    },
    "pagination": {
        "page": 1,
        "per_page": 25,
        "total": 12
    }
}

2.2. Filtering statistic

A `POST` request will return statistic.

2.2.1. Request Body

Path Type Description Required

timezone

integer

Timezone
"Etc/GMT+12"…​"Etc/GMT+1", "Etc/GMT", "Etc/GMT-1"…​"Etc/GMT-12" \n"America/Anchorage"…​"Europe/Istanbul", "Asia/Tokyo"

from

date

Start date (yyyy-mm-dd)

+

to

date

End date (yyyy-mm-dd)

+

groupBy

array

Grouping fields:
YMD - Date
YMDH - Date time. Period: 2 days max
campaignId - Campaign
creativeId - Creative
country - Country
connectionType - Connection Type
carrier - Carrier
sspId - Ssp
region - Region
city - City
browser - Browser
os - Device OS
appName - App Name
siteName - Domain Name
source - Source
originalPubId - Publisher Id
sitePage - Site Page
trafficType - Media Type
requestType - Traffic Type
deviceType - Mobile Type
language - Language
size - Width x Height
isPmpReq - Pmp

+

agregatedFields

array

Agregated fields:
bids - Bids
wins - Wins
impressions - Impressions
clicks - Clicks
conversions - Conversions
reach - Reach
dspSpend - Spend
ecpm - eCPM
ecpc - eCPC
ctr - CTR
winrate - Win Rate

+

filter.campaignId

integer

Filtering by Campaign Id(cid)

filter.creativeId

integer

Filtering by Creative Id(bid)

orderField

string

Sorting field

orderDir

string

Sort order: "asc" or "desc"

page

integer

Pagination: page number

rowsOnPage

integer

Pagination: rows on page (min:10, max:50000)

2.2.2. HTTP Request

URL

POST api/statistic HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjEsImV4cCI6MTc0Mjk4NjQyMSwibmJmIjoxNzQyOTgyODIxLCJqdGkiOiJCQmJtd0h1TFNQOXIzQWY3Iiwic3ViIjoiNTIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.4V8gh9m-6WGw0M_3saVMDCt3wpleEvouj3UUHu-TAVQ
DATA
{
    "timezone": "UTC",
    "from": "2025-03-24",
    "to": "2025-03-26",
    "groupBy": [
        "YMD",
        "campaignId",
        "creativeId"
    ],
    "agregatedFields": [
        "bids",
        "wins",
        "impressions",
        "clicks",
        "dspSpend",
        "winrate",
        "ctr"
    ],
    "filter": {
        "campaignId": 1,
        "creativeId": 10
    },
    "orderField": "YMD",
    "orderDir": "desc",
    "page": 1,
    "rowsOnPage": 25
}

2.2.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/statistic' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjEsImV4cCI6MTc0Mjk4NjQyMSwibmJmIjoxNzQyOTgyODIxLCJqdGkiOiJCQmJtd0h1TFNQOXIzQWY3Iiwic3ViIjoiNTIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.4V8gh9m-6WGw0M_3saVMDCt3wpleEvouj3UUHu-TAVQ' \
    -d '{
    "timezone": "UTC",
    "from": "2025-03-24",
    "to": "2025-03-26",
    "groupBy": [
        "YMD",
        "campaignId",
        "creativeId"
    ],
    "agregatedFields": [
        "bids",
        "wins",
        "impressions",
        "clicks",
        "dspSpend",
        "winrate",
        "ctr"
    ],
    "filter": {
        "campaignId": 1,
        "creativeId": 10
    },
    "orderField": "YMD",
    "orderDir": "desc",
    "page": 1,
    "rowsOnPage": 25
}'

2.2.4. Response Body

Path Type Description

status

string

Report status

data.*.YMD

date

Date

data.*.campaignId

integer

Campaign id

data.*.campaignId_dict

string

Campaign name

data.*.creativeId

integer

Creative id

data.*.creativeId_dict

string

Creative name

data.*.bids

integer

Bids

data.*.wins

integer

Wins

data.*.impressions

integer

Impressions

data.*.dspSpend

float

Spend, $

data.*.winrate

float

Win Rate, %

data.*.ecpm

integer

eCPM, $

data.*.clicks

integer

Clicks

data.*.conversions

integer

Conversions

data.*.ctr

float

CTR, %

totals.YMD

date

Date

totals.campaignId

integer

Campaign id

totals.campaignId_dict

string

Campaign name

totals.creativeId

integer

Creative id

totals.creativeId_dict

string

Creative name

totals.bids

integer

Bids

totals.wins

integer

Wins

totals.impressions

integer

Impressions

totals.dspSpend

float

Spend, $

totals.winrate

float

Win Rate, %

totals.ecpm

integer

eCPM, $

totals.clicks

integer

Clicks

totals.conversions

integer

Conversions

totals.ctr

float

CTR, %

pagination.page

integer

Pagination: current page number

pagination.per_page

integer

Pagination: items per page

pagination.total

integer

Pagination: total items count

2.2.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "status": "success",
    "data": [
        {
            "YMD": "2025-03-25",
            "campaignId": 1,
            "campaignId_dict": "Officia ut| id# 1",
            "creativeId": 10,
            "creativeId_dict": "Porro doloribus| id# 10",
            "bids": 940,
            "wins": 585,
            "impressions": 454,
            "dspSpend": 0.49999,
            "winrate": 62.234042553191486,
            "ecpm": 1.1012995594713657,
            "clicks": 22,
            "conversions": 23,
            "ctr": 4.845814977973569
        },
        {
            "YMD": "2025-03-26",
            "campaignId": 1,
            "campaignId_dict": "Veniam qui| id# 1",
            "creativeId": 10,
            "creativeId_dict": "Repudiandae sint| id# 10",
            "bids": 598,
            "wins": 265,
            "impressions": 235,
            "dspSpend": 0.20504,
            "winrate": 44.31438127090301,
            "ecpm": 0.8725106382978723,
            "clicks": 31,
            "conversions": 6,
            "ctr": 13.191489361702128
        },
        {
            "YMD": "2025-03-24",
            "campaignId": 1,
            "campaignId_dict": "Et eveniet| id# 1",
            "creativeId": 10,
            "creativeId_dict": "Nobis qui| id# 10",
            "bids": 957,
            "wins": 480,
            "impressions": 361,
            "dspSpend": 0.31358,
            "winrate": 50.156739811912225,
            "ecpm": 0.8686426592797785,
            "clicks": 49,
            "conversions": 12,
            "ctr": 13.573407202216066
        }
    ],
    "totals": {
        "YMD": "",
        "campaignId": 0,
        "campaignId_dict": "",
        "creativeId": 0,
        "creativeId_dict": "",
        "bids": 2495,
        "wins": 1330,
        "impressions": 1050,
        "dspSpend": 1.01861,
        "winrate": 52.23505454533557,
        "ecpm": 0.9474842856830055,
        "clicks": 102,
        "conversions": 41,
        "ctr": 10.536903847297253
    },
    "pagination": {
        "page": 1,
        "per_page": 25,
        "total": 3
    }
}

3. Agency

3.1. Deposit to advert

A `POST` request

3.1.1. Request Body

Path Type Description Required

userId

integer

user id

+

transactionAmount

integer

transaction amount

+

3.1.2. HTTP Request

URL

POST api/deposit-agency-user HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTUsImV4cCI6MTc0Mjk4NjQxNSwibmJmIjoxNzQyOTgyODE1LCJqdGkiOiJvT2dDRG5LTEprNkZlaWw0Iiwic3ViIjoiMSIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.37PqCoMD0UjHwo_YfVhoxuYL3grERm1itUVO8kEXF9o
DATA
{
    "userId": 2,
    "transactionAmount": 10
}

3.1.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/deposit-agency-user' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTUsImV4cCI6MTc0Mjk4NjQxNSwibmJmIjoxNzQyOTgyODE1LCJqdGkiOiJvT2dDRG5LTEprNkZlaWw0Iiwic3ViIjoiMSIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.37PqCoMD0UjHwo_YfVhoxuYL3grERm1itUVO8kEXF9o' \
    -d '{
    "userId": 2,
    "transactionAmount": 10
}'

3.1.4. Response Body

Path Type Description

status

string

Result status

balance

float

balance

3.1.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
{
    "status": "success",
    "balance": "12384.00000"
}

3.2. Withdraw to advert

A `POST` request

3.2.1. Request Body

Path Type Description Required

userId

integer

user id

+

transactionAmount

integer

transaction amount

+

3.2.2. HTTP Request

URL

POST api/withdraw-agency-user HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTUsImV4cCI6MTc0Mjk4NjQxNSwibmJmIjoxNzQyOTgyODE1LCJqdGkiOiJKSGRjM0x5WktRYm9mUnl3Iiwic3ViIjoiMyIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.eEs9UOOU_SFOA4g5BzLHyHQ5qrGxMGwDbs3ZXBDbezU
DATA
{
    "userId": 4,
    "transactionAmount": 10
}

3.2.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/withdraw-agency-user' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTUsImV4cCI6MTc0Mjk4NjQxNSwibmJmIjoxNzQyOTgyODE1LCJqdGkiOiJKSGRjM0x5WktRYm9mUnl3Iiwic3ViIjoiMyIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.eEs9UOOU_SFOA4g5BzLHyHQ5qrGxMGwDbs3ZXBDbezU' \
    -d '{
    "userId": 4,
    "transactionAmount": 10
}'

3.2.4. Response Body

Path Type Description

status

string

Result status

balance

float

balance

3.2.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
{
    "status": "success",
    "balance": "70974.00000"
}

3.3. User list with campaigns

A `GET` request

3.3.1. HTTP Request

URL

GET api/get-agency-users-with-campaigns HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTUsImV4cCI6MTc0Mjk4NjQxNSwibmJmIjoxNzQyOTgyODE1LCJqdGkiOiJ3U2RIeU50VkdXNDRXYTFUIiwic3ViIjoiNSIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.JlD4odLIr8pRM34tdOLxAagK7Av3Fn71KN4y8832O7A
DATA
{
    "where": "userId;5"
}

3.3.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/get-agency-users-with-campaigns' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTUsImV4cCI6MTc0Mjk4NjQxNSwibmJmIjoxNzQyOTgyODE1LCJqdGkiOiJ3U2RIeU50VkdXNDRXYTFUIiwic3ViIjoiNSIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.JlD4odLIr8pRM34tdOLxAagK7Av3Fn71KN4y8832O7A' \
    -d '{
    "where": "userId;5"
}'

3.3.3. Response Body

Path Type Description

data.*.id

integer

user id

data.*.firstName

string

First name

data.*.lastName

string

Last name

data.*.balance

float

balance

data.*.bidResTotalCounter

integer

Bid total counter

data.*.bidResDailyCounter

integer

Bid daily counter

data.*.winsTotalCounter

integer

Wins total counter

data.*.winsDailyCounter

integer

Wins daily counter

data.*.impressionsTotalCounter

integer

Impressions total counter

data.*.impressionsDailyCounter

integer

Impressions daily counter

data.*.clicksTotalCounter

integer

Click total counter

data.*.clicksDailyCounter

integer

Click daily counter

data.*.spentDailyLimit

integer

Spent daily limit

data.*.spentDailyCounter

integer

Spent daily counter

data.*.spentTotalLimit

integer

Spent total limit

data.*.spentTotalCounter

integer

Spent total counter

data.*.impressionsDailyLimit

integer

impressions daily limit

data.*.impressionsTotalLimit

integer

impressions total limit

data..campaigns..id

integer

campaign id

data..campaigns..userId

integer

user id

data..campaigns..isActive

boolean

isActive

data..campaigns..isRunning

boolean

Campaign running status

data..campaigns..type

string

Campaign type: banner, native, video, audio

data..campaigns..name

string

Campaign name

data..campaigns..isRewarded

integer

Rewarded video (for video creatives)

data..campaigns..isDesktopWeb

boolean

Traffic Type: Desktop Websites

data..campaigns..isMobileApp

boolean

Traffic Type: Mobile Applications

data..campaigns..isMobileWeb

boolean

Traffic Type: Mobile Websites

data..campaigns..isSmartphone

boolean

Traffic Type: Smartphones

data..campaigns..isTablet

boolean

Traffic Type: Tablets

data..campaigns..isCTV

boolean

Traffic Type: CTV

data..campaigns..isDOOH

boolean

Traffic Type: DOOH

data..campaigns..aDomain

integer

Top level domain

data..campaigns..dateStart

date

Date start

data..campaigns..dateEnd

date

Date end

data..campaigns..geoCountries

array

GEO Targeting: countries list

data..campaigns..geoCountriesIsInclude

boolean

GEO Targeting: countries list type (true: whitelist, false: blacklist)

data..campaigns..geoRegions

array

GEO Targeting: regions list

data..campaigns..geoRegionsIsInclude

boolean

GEO Targeting: regions list type (true: whitelist, false: blacklist)

data..campaigns..geoCities

array

GEO Targeting: cities list

data..campaigns..geoCitiesIsInclude

boolean

GEO Targeting: cities list type (true: whitelist, false: blacklist)

data..campaigns..contentCategories

array

Targeting: IAB Categories list

data..campaigns..contentCategoriesIsInclude

boolean

Targeting: IAB Categories list type (true: whitelist, false: blacklist)

data..campaigns..userAgeMin

integer

Targeting: Age range from

data..campaigns..userAgeMax

integer

Targeting: Age range to

data..campaigns..connectionTypes

array

Targeting: Connection types list

data..campaigns..clickedInventoryCategories

array

Сlicked Inventory Categories

data..campaigns..deviceCarrier

array

Targeting: List of network operators.

data..campaigns..deviceCarrierIsInclude

boolean

Targeting: List of network operators type (true: whitelist, false: blacklist)

data..campaigns..OS

array

Targeting: The operating system of user's device

data..campaigns..OSIsInclude

boolean

Targeting: The operating system of user's device list type (true: whitelist, false: blacklist)

data..campaigns..browser

array

Targeting: The user's browsers list

data..campaigns..browserIsInclude

boolean

Targeting: The user's browsers list type (true: whitelist, false: blacklist)

data..campaigns..deviceLanguage

array

Targeting: The languages of user's browser

data..campaigns..deviceLanguageIsInclude

boolean

Targeting: The languages of user's browser list type (true: whitelist, false: blacklist)

data..campaigns..spentDailyLimit

integer

Daily spent limit

data..campaigns..spentTotalLimit

integer

Total spent limit

data..campaigns..impressionsDailyLimit

integer

Daily impressions limit

data..campaigns..impressionsTotalLimit

integer

Total impressions limit

data..campaigns..clicksDailyLimit

integer

Daily clicks limit

data..campaigns..clicksTotalLimit

integer

Total clicks limit

data..campaigns..budgetUse

integer

Distribution: pacer, fast pacer - Evenly distribution fast - ASAP distribution

data..campaigns..allSources

boolean

Inventory: Use all SSP endpoints

data..campaigns..cpm

float

cpm

data..campaigns..adaptiveCpm

boolean

adaptiveCpm

data..campaigns..useCpm

boolean

use cpm

data..campaigns..googleAnalyticsTrackingCode

string

Google Analytics tracking code - PUSH Campaigns

data..campaigns..dynamicTargeting

array

SmartCPC: Dynamic targeting - only for CPC Pricing model

data..campaigns..subscriptionAge

array

Subscription Age - only for CPC Pricing model

data..campaigns..frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data..campaigns..frequency

boolean

Frequency on/off.

data..campaigns..frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data..campaigns..frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data..campaigns..extendedStatus

string

Campaign extended status

data..campaigns..createdAt

datetime

Date of creation

data..campaigns..updatedAt

datetime

Date of last modification

data..campaigns..deletedAt

datetime

Date of deletion

data..campaigns..counters.spentDailyCounter

integer

Spent daily counter

data..campaigns..counters.spentTotalCounter

integer

Spent total counter

data..campaigns..counters.bidResTotalCounter

integer

Bid total counter

data..campaigns..counters.bidResDailyCounter

integer

Bid daily counter

data..campaigns..counters.conversionTotalCounter

integer

Conversion total counter

data..campaigns..counters.conversionDailyCounter

integer

Conversion daily counter

data..campaigns..counters.winsTotalCounter

integer

Wins total counter

data..campaigns..counters.winsDailyCounter

integer

Wins daily counter

data..campaigns..counters.clicksTotalCounter

integer

Click total counter

data..campaigns..counters.clicksDailyCounter

integer

Click daily counter

data..campaigns..counters.impressionsTotalCounter

integer

Impressions total counter

data..campaigns..counters.impressionsDailyCounter

integer

Impressions daily counter

data..campaigns..counters.winRate

integer

Winrate counter

data..campaigns..pretarget

int

pretarget

data..campaigns..pretargets

array

pretargets

data..campaigns..audiences

array

audiences

meta.pagination.total

integer

Pagination: total items count

meta.pagination.count

integer

Pagination: page items count

meta.pagination.per_page

integer

Pagination: items per page

meta.pagination.current_page

integer

Pagination: current page number

meta.pagination.total_pages

integer

Pagination: total pages count

meta.pagination.links

string

Pagination: url links

3.3.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
{
    "data": [
        {
            "id": 5,
            "firstName": "Rex",
            "lastName": "Upton",
            "balance": null,
            "bidResTotalCounter": null,
            "bidResDailyCounter": null,
            "winsTotalCounter": null,
            "winsDailyCounter": null,
            "impressionsTotalCounter": null,
            "impressionsDailyCounter": null,
            "clicksTotalCounter": null,
            "clicksDailyCounter": null,
            "spentDailyLimit": "730",
            "spentDailyCounter": null,
            "spentTotalLimit": "12176",
            "spentTotalCounter": null,
            "impressionsDailyLimit": "428016",
            "impressionsTotalLimit": "800000",
            "campaigns": [
                {
                    "id": 1,
                    "userId": 5,
                    "isActive": false,
                    "isRunning": false,
                    "type": "video",
                    "name": "Rerum.",
                    "isRewarded": false,
                    "isDesktopWeb": false,
                    "isMobileApp": false,
                    "isMobileWeb": true,
                    "isSmartphone": true,
                    "isTablet": false,
                    "isCTV": false,
                    "isDOOH": true,
                    "aDomain": "mcglynn.com",
                    "dateStart": "2023-08-05",
                    "dateEnd": "2025-11-07",
                    "geoCountries": [],
                    "geoCountriesIsInclude": true,
                    "geoRegions": [],
                    "geoRegionsIsInclude": true,
                    "geoCities": [],
                    "geoCitiesIsInclude": true,
                    "contentCategories": [],
                    "contentCategoriesIsInclude": true,
                    "userAgeMin": 0,
                    "userAgeMax": 0,
                    "connectionTypes": [
                        "wifi"
                    ],
                    "clickedInventoryCategories": [],
                    "deviceCarrier": [],
                    "deviceCarrierIsInclude": true,
                    "OS": [],
                    "OSIsInclude": true,
                    "browser": [],
                    "browserIsInclude": true,
                    "deviceLanguage": [],
                    "deviceLanguageIsInclude": true,
                    "spentDailyLimit": 391,
                    "spentTotalLimit": 5943,
                    "impressionsDailyLimit": 225942,
                    "impressionsTotalLimit": 400000,
                    "clicksDailyLimit": 0,
                    "clicksTotalLimit": 0,
                    "budgetUse": "fast",
                    "allSources": true,
                    "cpm": 0,
                    "adaptiveCpm": false,
                    "useCpm": false,
                    "googleAnalyticsTrackingCode": null,
                    "dynamicTargeting": [],
                    "subscriptionAge": [],
                    "frequencyType": "user",
                    "frequency": 0,
                    "frequencyCap": 1,
                    "frequencyPeriod": 1,
                    "extendedStatus": "Campaign is not active",
                    "createdAt": "2025-03-26",
                    "updatedAt": "2025-03-26",
                    "deletedAt": null,
                    "counters": {
                        "spentDailyCounter": 0,
                        "spentTotalCounter": 0,
                        "bidResTotalCounter": 0,
                        "bidResDailyCounter": 0,
                        "conversionTotalCounter": 0,
                        "conversionDailyCounter": 0,
                        "winsTotalCounter": 0,
                        "winsDailyCounter": 0,
                        "clicksTotalCounter": null,
                        "clicksDailyCounter": null,
                        "impressionsTotalCounter": 0,
                        "impressionsDailyCounter": 0,
                        "winRate": 0
                    },
                    "pretarget": null,
                    "pretargets": [],
                    "audiences": []
                },
                {
                    "id": 2,
                    "userId": 5,
                    "isActive": true,
                    "isRunning": false,
                    "type": "video",
                    "name": "Et.",
                    "isRewarded": false,
                    "isDesktopWeb": true,
                    "isMobileApp": true,
                    "isMobileWeb": true,
                    "isSmartphone": false,
                    "isTablet": false,
                    "isCTV": true,
                    "isDOOH": false,
                    "aDomain": "quitzon.net",
                    "dateStart": "2024-04-17",
                    "dateEnd": "2026-02-08",
                    "geoCountries": [],
                    "geoCountriesIsInclude": true,
                    "geoRegions": [],
                    "geoRegionsIsInclude": true,
                    "geoCities": [],
                    "geoCitiesIsInclude": true,
                    "contentCategories": [],
                    "contentCategoriesIsInclude": true,
                    "userAgeMin": 0,
                    "userAgeMax": 0,
                    "connectionTypes": [
                        "wifi"
                    ],
                    "clickedInventoryCategories": [],
                    "deviceCarrier": [],
                    "deviceCarrierIsInclude": true,
                    "OS": [],
                    "OSIsInclude": true,
                    "browser": [],
                    "browserIsInclude": true,
                    "deviceLanguage": [],
                    "deviceLanguageIsInclude": true,
                    "spentDailyLimit": 339,
                    "spentTotalLimit": 6233,
                    "impressionsDailyLimit": 202074,
                    "impressionsTotalLimit": 400000,
                    "clicksDailyLimit": 0,
                    "clicksTotalLimit": 0,
                    "budgetUse": "fast",
                    "allSources": true,
                    "cpm": 0,
                    "adaptiveCpm": false,
                    "useCpm": false,
                    "googleAnalyticsTrackingCode": null,
                    "dynamicTargeting": [],
                    "subscriptionAge": [],
                    "frequencyType": "user",
                    "frequency": 0,
                    "frequencyCap": 1,
                    "frequencyPeriod": 1,
                    "extendedStatus": "Low Balance",
                    "createdAt": "2025-03-26",
                    "updatedAt": "2025-03-26",
                    "deletedAt": null,
                    "counters": {
                        "spentDailyCounter": 0,
                        "spentTotalCounter": 0,
                        "bidResTotalCounter": 0,
                        "bidResDailyCounter": 0,
                        "conversionTotalCounter": 0,
                        "conversionDailyCounter": 0,
                        "winsTotalCounter": 0,
                        "winsDailyCounter": 0,
                        "clicksTotalCounter": null,
                        "clicksDailyCounter": null,
                        "impressionsTotalCounter": 0,
                        "impressionsDailyCounter": 0,
                        "winRate": 0
                    },
                    "pretarget": null,
                    "pretargets": [],
                    "audiences": []
                }
            ]
        }
    ],
    "meta": {
        "pagination": {
            "total": 1,
            "count": 1,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 1,
            "links": []
        }
    }
}

4. Campaigns

4.1. Campaigns list

A `GET` request will return a list of an campaigns.

4.1.1. HTTP Request

URL

GET api/campaigns HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiI5RFoyeGgycnNsTmlWQlhZIiwic3ViIjoiOSIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.F8FLexifVchwOu2nr5lOeC3LOThQISHUQXRszwFtMEE
DATA
{}

4.1.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiI5RFoyeGgycnNsTmlWQlhZIiwic3ViIjoiOSIsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.F8FLexifVchwOu2nr5lOeC3LOThQISHUQXRszwFtMEE' \
    -d '{}'

4.1.3. Response Body

Path Type Description

data.*.id

integer

Campaign Id(test)

data.*.userId

integer

User Id

data.*.isActive

boolean

Campaign On/Off

data.*.isRunning

boolean

Campaign running status

data.*.type

string

Campaign type: banner, native, video, audio

data.*.name

string

Campaign name

data.*.isRewarded

integer

Rewarded video (for video creatives)

data.*.isDesktopWeb

boolean

Traffic Type: Desktop Websites

data.*.isMobileApp

boolean

Traffic Type: Mobile Applications

data.*.isMobileWeb

boolean

Traffic Type: Mobile Websites

data.*.isSmartphone

boolean

Traffic Type: Smartphones

data.*.isTablet

boolean

Traffic Type: Tablets

data.*.isCTV

boolean

Traffic Type: CTVs

data.*.isDOOH

boolean

Traffic Type: DOOH

data.*.aDomain

integer

Top level domain

data.*.dateStart

date

Date start

data.*.dateEnd

date

Date end

data.*.geoCountries

array

GEO Targeting: countries list

data.*.geoCountriesIsInclude

boolean

GEO Targeting: countries list type (true: whitelist, false: blacklist)

data.*.geoRegions

array

GEO Targeting: regions list

data.*.geoRegionsIsInclude

boolean

GEO Targeting: regions list type (true: whitelist, false: blacklist)

data.*.geoCities

array

GEO Targeting: cities list

data.*.geoCitiesIsInclude

boolean

GEO Targeting: cities list type (true: whitelist, false: blacklist)

data.*.contentCategories

array

Targeting: IAB Categories list

data.*.contentCategoriesIsInclude

boolean

Targeting: IAB Categories list type (true: whitelist, false: blacklist)

data.*.userAgeMin

integer

Targeting: Age range from

data.*.userAgeMax

integer

Targeting: Age range to

data.*.connectionTypes

array

Targeting: Connection types list

data.*.clickedInventoryCategories

array

Сlicked Inventory Categories

data.*.deviceCarrier

array

Targeting: List of network operators.

data.*.deviceCarrierIsInclude

boolean

Targeting: List of network operators type (true: whitelist, false: blacklist)

data.*.OS

array

Targeting: The operating system of user's device

data.*.OSIsInclude

boolean

Targeting: The operating system of user's device list type (true: whitelist, false: blacklist)

data.*.browser

array

Targeting: The user's browsers list

data.*.browserIsInclude

boolean

Targeting: The user's browsers list type (true: whitelist, false: blacklist)

data.*.deviceLanguage

array

Targeting: The languages of user's browser

data.*.deviceLanguageIsInclude

boolean

Targeting: The languages of user's browser list type (true: whitelist, false: blacklist)

data.*.spentDailyLimit

integer

Daily spent limit

data.*.spentTotalLimit

integer

Total spent limit

data.*.impressionsDailyLimit

integer

Daily impressions limit

data.*.impressionsTotalLimit

integer

Total impressions limit

data.*.clicksDailyLimit

integer

Daily clicks limit

data.*.clicksTotalLimit

integer

Total clicks limit

data.*.budgetUse

integer

Distribution: pacer, fast pacer - Evenly distribution fast - ASAP distribution

data.*.allSources

boolean

Inventory: Use all SSP endpoints

data.*.cpm

float

cpm

data.*.adaptiveCpm

boolean

adaptiveCpm

data.*.useCpm

boolean

use cpm

data.*.extendedStatus

string

Campaign extended status

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

data.*.deletedAt

datetime

Date of deletion

meta.pagination.total

integer

Pagination: total items count

meta.pagination.count

integer

Pagination: page items count

meta.pagination.per_page

integer

Pagination: items per page

meta.pagination.current_page

integer

Pagination: current page number

meta.pagination.total_pages

integer

Pagination: total pages count

meta.pagination.links

array

Pagination: urls to next,prev page

4.1.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": [
        {
            "id": 3,
            "userId": 9,
            "isActive": false,
            "isRunning": false,
            "type": "native",
            "name": "Qui.",
            "isRewarded": false,
            "isDesktopWeb": true,
            "isMobileApp": false,
            "isMobileWeb": true,
            "isSmartphone": false,
            "isTablet": false,
            "isCTV": true,
            "isDOOH": true,
            "aDomain": "kuhn.com",
            "dateStart": "2025-01-13",
            "dateEnd": "2025-06-10",
            "geoCountries": [],
            "geoCountriesIsInclude": true,
            "geoRegions": [],
            "geoRegionsIsInclude": true,
            "geoCities": [],
            "geoCitiesIsInclude": true,
            "contentCategories": [],
            "contentCategoriesIsInclude": true,
            "userAgeMin": 0,
            "userAgeMax": 0,
            "connectionTypes": [
                "wifi"
            ],
            "clickedInventoryCategories": [],
            "deviceCarrier": [],
            "deviceCarrierIsInclude": true,
            "OS": [],
            "OSIsInclude": true,
            "browser": [],
            "browserIsInclude": true,
            "deviceLanguage": [],
            "deviceLanguageIsInclude": true,
            "spentDailyLimit": 428,
            "spentTotalLimit": 1853,
            "impressionsDailyLimit": 262053,
            "impressionsTotalLimit": 400000,
            "clicksDailyLimit": 0,
            "clicksTotalLimit": 0,
            "budgetUse": "fast",
            "allSources": true,
            "cpm": 0,
            "adaptiveCpm": false,
            "useCpm": false,
            "extendedStatus": "Campaign is not active",
            "createdAt": "2025-03-26",
            "updatedAt": "2025-03-26",
            "deletedAt": null
        },
        {
            "id": 4,
            "userId": 9,
            "isActive": false,
            "isRunning": false,
            "type": "native",
            "name": "Corporis.",
            "isRewarded": false,
            "isDesktopWeb": true,
            "isMobileApp": false,
            "isMobileWeb": false,
            "isSmartphone": false,
            "isTablet": false,
            "isCTV": false,
            "isDOOH": false,
            "aDomain": "walsh.com",
            "dateStart": "2024-09-21",
            "dateEnd": "2025-07-26",
            "geoCountries": [],
            "geoCountriesIsInclude": true,
            "geoRegions": [],
            "geoRegionsIsInclude": true,
            "geoCities": [],
            "geoCitiesIsInclude": true,
            "contentCategories": [],
            "contentCategoriesIsInclude": true,
            "userAgeMin": 0,
            "userAgeMax": 0,
            "connectionTypes": [
                "wifi"
            ],
            "clickedInventoryCategories": [],
            "deviceCarrier": [],
            "deviceCarrierIsInclude": true,
            "OS": [],
            "OSIsInclude": true,
            "browser": [],
            "browserIsInclude": true,
            "deviceLanguage": [],
            "deviceLanguageIsInclude": true,
            "spentDailyLimit": 412,
            "spentTotalLimit": 7647,
            "impressionsDailyLimit": 268572,
            "impressionsTotalLimit": 400000,
            "clicksDailyLimit": 0,
            "clicksTotalLimit": 0,
            "budgetUse": "fast",
            "allSources": true,
            "cpm": 0,
            "adaptiveCpm": false,
            "useCpm": false,
            "extendedStatus": "Campaign is not active",
            "createdAt": "2025-03-26",
            "updatedAt": "2025-03-26",
            "deletedAt": null
        }
    ],
    "meta": {
        "pagination": {
            "total": 2,
            "count": 2,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 1,
            "links": []
        }
    }
}

4.2. Get by ID

A `GET` request with a path parameter of the id will return the campaign with that id.

4.2.1. HTTP Request

URL

GET api/campaigns/5 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiI2WkZrWk5JSW53YTRRYkdrIiwic3ViIjoiMTAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.OmDemcZtOZE9qF1xBhQGr-_PI66U2OpI3F86qBP4g_c
DATA
{}

4.2.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/5' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiI2WkZrWk5JSW53YTRRYkdrIiwic3ViIjoiMTAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.OmDemcZtOZE9qF1xBhQGr-_PI66U2OpI3F86qBP4g_c' \
    -d '{}'

4.2.3. Response Body

Path Type Description

data.id

integer

Campaign Id

data.userId

integer

User Id

data.isActive

boolean

Campaign On/Off

data.isRunning

boolean

Campaign running status

data.type

string

Campaign type: banner, native, video, audio

data.name

string

Campaign name

data.isRewarded

integer

Rewarded video (for video creatives)

data.isDesktopWeb

boolean

Traffic Type: Desktop Websites

data.isMobileApp

boolean

Traffic Type: Mobile Applications

data.isMobileWeb

boolean

Traffic Type: Mobile Websites

data.isSmartphone

boolean

Traffic Type: Smartphones

data.isTablet

boolean

Traffic Type: Tablets

data.isCTV

boolean

Traffic Type: CTV

data.isDOOH

boolean

Traffic Type: DOOH

data.aDomain

integer

Top level domain

data.dateStart

date

Date start

data.dateEnd

date

Date end

data.geoCountries

array

GEO Targeting: countries list

data.geoCountriesIsInclude

boolean

GEO Targeting: countries list type (true: whitelist, false: blacklist)

data.geoRegions

array

GEO Targeting: regions list

data.geoRegionsIsInclude

boolean

GEO Targeting: regions list type (true: whitelist, false: blacklist)

data.geoCities

array

GEO Targeting: cities list

data.geoCitiesIsInclude

boolean

GEO Targeting: cities list type (true: whitelist, false: blacklist)

data.contentCategories

array

Targeting: IAB Categories list

data.contentCategoriesIsInclude

boolean

Targeting: IAB Categories list type (true: whitelist, false: blacklist)

data.userAgeMin

integer

Targeting: Age range from

data.userAgeMax

integer

Targeting: Age range to

data.connectionTypes

array

Targeting: Connection types list

data.clickedInventoryCategories

array

Сlicked Inventory Categories

data.deviceCarrier

array

Targeting: List of network operators.

data.deviceCarrierIsInclude

boolean

Targeting: List of network operators type (true: whitelist, false: blacklist)

data.OS

array

Targeting: The operating system of user's device

data.OSIsInclude

boolean

Targeting: The operating system of user's device list type (true: whitelist, false: blacklist)

data.browser

array

Targeting: The user's browsers list

data.browserIsInclude

boolean

Targeting: The user's browsers list type (true: whitelist, false: blacklist)

data.deviceLanguage

array

Targeting: The languages of user's browser

data.deviceLanguageIsInclude

boolean

Targeting: The languages of user's browser list type (true: whitelist, false: blacklist)

data.spentDailyLimit

integer

Daily spent limit

data.spentTotalLimit

integer

Total spent limit

data.impressionsDailyLimit

integer

Daily impressions limit

data.impressionsTotalLimit

integer

Total impressions limit

data.clicksDailyLimit

integer

Daily clicks limit

data.clicksTotalLimit

integer

Total clicks limit

data.budgetUse

integer

Distribution: pacer, fast pacer - Evenly distribution fast - ASAP distribution

data.allSources

boolean

Inventory: Use all SSP endpoints

data.cpm

float

cpm

data.adaptiveCpm

boolean

adaptiveCpm

data.useCpm

boolean

use cpm

data.googleAnalyticsTrackingCode

string

Google Analytics tracking code - PUSH Campaigns

data.dynamicTargeting

array

SmartCPC: Dynamic targeting - only for CPC Pricing model

data.subscriptionAge

array

Subscription Age - only for CPC Pricing model

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.extendedStatus

string

Campaign extended status

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.deletedAt

datetime

Date of deletion

data.pretarget

int

pretarget

data.pretargets

array

pretargets

data.audiences

array

audiences

4.2.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 5,
        "userId": 10,
        "isActive": false,
        "isRunning": false,
        "type": "audio",
        "name": "Test Campaign #1",
        "isRewarded": false,
        "isDesktopWeb": false,
        "isMobileApp": false,
        "isMobileWeb": false,
        "isSmartphone": false,
        "isTablet": false,
        "isCTV": false,
        "isDOOH": false,
        "aDomain": "lakin.com",
        "dateStart": "2023-07-08",
        "dateEnd": "2026-03-05",
        "geoCountries": [],
        "geoCountriesIsInclude": true,
        "geoRegions": [],
        "geoRegionsIsInclude": true,
        "geoCities": [],
        "geoCitiesIsInclude": true,
        "contentCategories": [],
        "contentCategoriesIsInclude": true,
        "userAgeMin": 0,
        "userAgeMax": 0,
        "connectionTypes": [
            "wifi"
        ],
        "clickedInventoryCategories": [],
        "deviceCarrier": [],
        "deviceCarrierIsInclude": true,
        "OS": [],
        "OSIsInclude": true,
        "browser": [],
        "browserIsInclude": true,
        "deviceLanguage": [],
        "deviceLanguageIsInclude": true,
        "spentDailyLimit": 108,
        "spentTotalLimit": 8549,
        "impressionsDailyLimit": 224239,
        "impressionsTotalLimit": 400000,
        "clicksDailyLimit": 0,
        "clicksTotalLimit": 0,
        "budgetUse": "fast",
        "allSources": true,
        "cpm": 0,
        "adaptiveCpm": false,
        "useCpm": false,
        "googleAnalyticsTrackingCode": null,
        "dynamicTargeting": [],
        "subscriptionAge": [],
        "frequencyType": "user",
        "frequency": 0,
        "frequencyCap": 1,
        "frequencyPeriod": 1,
        "extendedStatus": "Campaign is not active",
        "createdAt": "2025-03-26",
        "updatedAt": "2025-03-26",
        "deletedAt": null,
        "pretarget": null,
        "pretargets": [],
        "audiences": []
    }
}

4.3. Create a Custom Banner/Native/Video/Audio Campaigns

A `POST` request will create new campaign.

4.3.1. Request Body

Path Type Description Required

type

string

Campaign type: banner, native, video, audio

+

name

string

Campaign name

+

aDomain

integer

Top level domain

+

isRewarded

integer

Rewarded video (for video creatives)

isDesktopWeb

boolean

Traffic Type: Desktop Websites

isMobileApp

boolean

Traffic Type: Mobile Applications

isMobileWeb

boolean

Traffic Type: Mobile Websites

isSmartphone

boolean

Traffic Type: Smartphones

isTablet

boolean

Traffic Type: Tablets

contentCategories

array

Targeting: IAB Categories list

contentCategoriesIsInclude

boolean

Targeting: IAB Categories list type (true: whitelist, false: blacklist)

userAgeMin

integer

Targeting: Age range from

userAgeMax

integer

Targeting: Age range to

connectionTypes

array

Targeting: Connection types list

deviceCarrier

array

Targeting: List of network operators.

deviceCarrierIsInclude

boolean

Targeting: List of network operators type (true: whitelist, false: blacklist)

OS

array

Targeting: The operating system of user's device

OSIsInclude

boolean

Targeting: The operating system of user's device list type (true: whitelist, false: blacklist)

browser

array

Targeting: The user's browsers list

browserIsInclude

boolean

Targeting: The user's browsers list type (true: whitelist, false: blacklist)

deviceLanguage

array

Targeting: The languages of user's browser

deviceLanguageIsInclude

boolean

Targeting: The languages of user's browser list type (true: whitelist, false: blacklist)

spentDailyLimit

integer

Daily spent limit

spentTotalLimit

integer

Total spent limit

impressionsDailyLimit

integer

Daily impressions limit

impressionsTotalLimit

integer

Total impressions limit

clicksDailyLimit

integer

Daily clicks limit

clicksTotalLimit

integer

Total clicks limit

budgetUse

integer

Distribution: pacer, fast pacer - Evenly distribution fast - ASAP distribution

dateStart

date

Date start

dateEnd

date

Date end

4.3.2. HTTP Request

URL

POST api/campaigns HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJtem9IQktFcktoUE5RNmlsIiwic3ViIjoiMTEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.tvzmD-oCEX83pGhN20OnQYSzHyGJJ6gQmW6mqBK9bZM
DATA
{
    "type": "banner",
    "name": "New Campaign #2",
    "aDomain": "turner.biz",
    "isRewarded": true,
    "isDesktopWeb": true,
    "isMobileApp": true,
    "isMobileWeb": true,
    "isSmartphone": true,
    "isTablet": true,
    "contentCategories": [
        "IAB1",
        "IAB3"
    ],
    "contentCategoriesIsInclude": false,
    "userAgeMin": 18,
    "userAgeMax": 50,
    "connectionTypes": [
        "ethernet",
        "cellular_all",
        "cellular_3g",
        "cellular_4g",
        "wifi"
    ],
    "deviceCarrier": [
        "ISP Green-Stiedemann",
        "ISP Simonis Inc"
    ],
    "deviceCarrierIsInclude": false,
    "OS": [
        "Android 8.0",
        "Android 8.1",
        "Android 9.0",
        "Android 10.0",
        "Android 11.0",
        "Android 12.0",
        "Android 13.0",
        "iOS"
    ],
    "OSIsInclude": true,
    "browser": [
        "Chrome",
        "IE",
        "Edge"
    ],
    "browserIsInclude": true,
    "deviceLanguage": [
        "ab",
        "aa"
    ],
    "deviceLanguageIsInclude": true,
    "spentDailyLimit": 200,
    "spentTotalLimit": 1000,
    "impressionsDailyLimit": 100000,
    "impressionsTotalLimit": 1000000,
    "clicksDailyLimit": 500,
    "clicksTotalLimit": 1000,
    "budgetUse": "fast",
    "dateStart": "2024-08-24",
    "dateEnd": "2026-02-19"
}

4.3.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJtem9IQktFcktoUE5RNmlsIiwic3ViIjoiMTEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.tvzmD-oCEX83pGhN20OnQYSzHyGJJ6gQmW6mqBK9bZM' \
    -d '{
    "type": "banner",
    "name": "New Campaign #2",
    "aDomain": "turner.biz",
    "isRewarded": true,
    "isDesktopWeb": true,
    "isMobileApp": true,
    "isMobileWeb": true,
    "isSmartphone": true,
    "isTablet": true,
    "contentCategories": [
        "IAB1",
        "IAB3"
    ],
    "contentCategoriesIsInclude": false,
    "userAgeMin": 18,
    "userAgeMax": 50,
    "connectionTypes": [
        "ethernet",
        "cellular_all",
        "cellular_3g",
        "cellular_4g",
        "wifi"
    ],
    "deviceCarrier": [
        "ISP Green-Stiedemann",
        "ISP Simonis Inc"
    ],
    "deviceCarrierIsInclude": false,
    "OS": [
        "Android 8.0",
        "Android 8.1",
        "Android 9.0",
        "Android 10.0",
        "Android 11.0",
        "Android 12.0",
        "Android 13.0",
        "iOS"
    ],
    "OSIsInclude": true,
    "browser": [
        "Chrome",
        "IE",
        "Edge"
    ],
    "browserIsInclude": true,
    "deviceLanguage": [
        "ab",
        "aa"
    ],
    "deviceLanguageIsInclude": true,
    "spentDailyLimit": 200,
    "spentTotalLimit": 1000,
    "impressionsDailyLimit": 100000,
    "impressionsTotalLimit": 1000000,
    "clicksDailyLimit": 500,
    "clicksTotalLimit": 1000,
    "budgetUse": "fast",
    "dateStart": "2024-08-24",
    "dateEnd": "2026-02-19"
}'

4.3.4. Response Body

Path Type Description

data.id

integer

Campaign Id

data.userId

integer

User Id

data.isActive

boolean

Campaign On/Off

data.isRunning

boolean

Campaign running status

data.type

string

Campaign type: banner, native, video, audio

data.name

string

Campaign name

data.isRewarded

integer

Rewarded video (for video creatives)

data.isDesktopWeb

boolean

Traffic Type: Desktop Websites

data.isMobileApp

boolean

Traffic Type: Mobile Applications

data.isMobileWeb

boolean

Traffic Type: Mobile Websites

data.isSmartphone

boolean

Traffic Type: Smartphones

data.isTablet

boolean

Traffic Type: Tablets

data.isCTV

boolean

Traffic Type: CTV

data.isDOOH

boolean

Traffic Type: DOOH

data.aDomain

integer

Top level domain

data.dateStart

date

Date start

data.dateEnd

date

Date end

data.geoCountries

array

GEO Targeting: countries list

data.geoCountriesIsInclude

boolean

GEO Targeting: countries list type (true: whitelist, false: blacklist)

data.geoRegions

array

GEO Targeting: regions list

data.geoRegionsIsInclude

boolean

GEO Targeting: regions list type (true: whitelist, false: blacklist)

data.geoCities

array

GEO Targeting: cities list

data.geoCitiesIsInclude

boolean

GEO Targeting: cities list type (true: whitelist, false: blacklist)

data.contentCategories

array

Targeting: IAB Categories list

data.contentCategoriesIsInclude

boolean

Targeting: IAB Categories list type (true: whitelist, false: blacklist)

data.userAgeMin

integer

Targeting: Age range from

data.userAgeMax

integer

Targeting: Age range to

data.connectionTypes

array

Targeting: Connection types list

data.clickedInventoryCategories

array

Сlicked Inventory Categories

data.deviceCarrier

array

Targeting: List of network operators.

data.deviceCarrierIsInclude

boolean

Targeting: List of network operators type (true: whitelist, false: blacklist)

data.OS

array

Targeting: The operating system of user's device

data.OSIsInclude

boolean

Targeting: The operating system of user's device list type (true: whitelist, false: blacklist)

data.browser

array

Targeting: The user's browsers list

data.browserIsInclude

boolean

Targeting: The user's browsers list type (true: whitelist, false: blacklist)

data.deviceLanguage

array

Targeting: The languages of user's browser

data.deviceLanguageIsInclude

boolean

Targeting: The languages of user's browser list type (true: whitelist, false: blacklist)

data.spentDailyLimit

integer

Daily spent limit

data.spentTotalLimit

integer

Total spent limit

data.impressionsDailyLimit

integer

Daily impressions limit

data.impressionsTotalLimit

integer

Total impressions limit

data.clicksDailyLimit

integer

Daily clicks limit

data.clicksTotalLimit

integer

Total clicks limit

data.budgetUse

integer

Distribution: pacer, fast pacer - Evenly distribution fast - ASAP distribution

data.allSources

boolean

Inventory: Use all SSP endpoints

data.cpm

float

cpm

data.adaptiveCpm

boolean

adaptiveCpm

data.useCpm

boolean

use cpm

data.googleAnalyticsTrackingCode

string

Google Analytics tracking code - PUSH Campaigns

data.dynamicTargeting

array

SmartCPC: Dynamic targeting - only for CPC Pricing model

data.subscriptionAge

array

Subscription Age - only for CPC Pricing model

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.extendedStatus

string

Campaign extended status

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.deletedAt

datetime

Date of deletion

data.pretarget

int

pretarget

data.pretargets

array

pretargets

data.audiences

array

audiences

4.3.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 6,
        "userId": 11,
        "isActive": null,
        "isRunning": false,
        "type": "banner",
        "name": "New Campaign #2",
        "isRewarded": true,
        "isDesktopWeb": true,
        "isMobileApp": true,
        "isMobileWeb": true,
        "isSmartphone": true,
        "isTablet": true,
        "isCTV": true,
        "isDOOH": true,
        "aDomain": "turner.biz",
        "dateStart": "2024-08-24",
        "dateEnd": "2026-02-19",
        "geoCountries": [],
        "geoCountriesIsInclude": false,
        "geoRegions": [],
        "geoRegionsIsInclude": null,
        "geoCities": [],
        "geoCitiesIsInclude": false,
        "contentCategories": [
            "IAB1",
            "IAB3"
        ],
        "contentCategoriesIsInclude": false,
        "userAgeMin": 18,
        "userAgeMax": 50,
        "connectionTypes": [
            "ethernet",
            "cellular_all",
            "cellular_3g",
            "cellular_4g",
            "wifi"
        ],
        "clickedInventoryCategories": [],
        "deviceCarrier": [
            "ISP Green-Stiedemann",
            "ISP Simonis Inc"
        ],
        "deviceCarrierIsInclude": false,
        "OS": [
            "Android 8.0",
            "Android 8.1",
            "Android 9.0",
            "Android 10.0",
            "Android 11.0",
            "Android 12.0",
            "Android 13.0",
            "iOS"
        ],
        "OSIsInclude": true,
        "browser": [
            "Chrome",
            "IE",
            "Edge"
        ],
        "browserIsInclude": true,
        "deviceLanguage": [
            "ab",
            "aa"
        ],
        "deviceLanguageIsInclude": true,
        "spentDailyLimit": 200,
        "spentTotalLimit": 1000,
        "impressionsDailyLimit": 100000,
        "impressionsTotalLimit": 1000000,
        "clicksDailyLimit": 500,
        "clicksTotalLimit": 1000,
        "budgetUse": "fast",
        "allSources": false,
        "cpm": null,
        "adaptiveCpm": null,
        "useCpm": null,
        "googleAnalyticsTrackingCode": null,
        "dynamicTargeting": [],
        "subscriptionAge": [],
        "frequencyType": null,
        "frequency": null,
        "frequencyCap": 0,
        "frequencyPeriod": 0,
        "extendedStatus": "Campaign is not active",
        "createdAt": "2025-03-26",
        "updatedAt": "2025-03-26",
        "deletedAt": null,
        "pretarget": null,
        "pretargets": [],
        "audiences": []
    }
}

4.4. Update a Custom Campaign

A `PATCH` request will update campaign.

4.4.1. Request Body

Path Type Description Required

name

string

Campaign name

4.4.2. HTTP Request

URL

PATCH api/campaigns/7 HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJMSVJITWhxNWxBdWpja3NOIiwic3ViIjoiMTIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.XboMLZNh4-MsBqs5wtoB7yCD8LcYhZGhzubpjAyUNkk
DATA
{
    "name": "Updated Campaign #3"
}

4.4.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/7' -i -X PATCH \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJMSVJITWhxNWxBdWpja3NOIiwic3ViIjoiMTIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.XboMLZNh4-MsBqs5wtoB7yCD8LcYhZGhzubpjAyUNkk' \
    -d '{
    "name": "Updated Campaign #3"
}'

4.4.4. Response Body

Path Type Description

data.id

integer

Campaign Id

data.userId

integer

User Id

data.isActive

boolean

Campaign On/Off

data.isRunning

boolean

Campaign running status

data.type

string

Campaign type: banner, native, video, audio

data.name

string

Campaign name

data.isRewarded

integer

Rewarded video (for video creatives)

data.isDesktopWeb

boolean

Traffic Type: Desktop Websites

data.isMobileApp

boolean

Traffic Type: Mobile Applications

data.isMobileWeb

boolean

Traffic Type: Mobile Websites

data.isSmartphone

boolean

Traffic Type: Smartphones

data.isTablet

boolean

Traffic Type: Tablets

data.isCTV

boolean

Traffic Type: CTV

data.isDOOH

boolean

Traffic Type: DOOH

data.aDomain

integer

Top level domain

data.dateStart

date

Date start

data.dateEnd

date

Date end

data.geoCountries

array

GEO Targeting: countries list

data.geoCountriesIsInclude

boolean

GEO Targeting: countries list type (true: whitelist, false: blacklist)

data.geoRegions

array

GEO Targeting: regions list

data.geoRegionsIsInclude

boolean

GEO Targeting: regions list type (true: whitelist, false: blacklist)

data.geoCities

array

GEO Targeting: cities list

data.geoCitiesIsInclude

boolean

GEO Targeting: cities list type (true: whitelist, false: blacklist)

data.contentCategories

array

Targeting: IAB Categories list

data.contentCategoriesIsInclude

boolean

Targeting: IAB Categories list type (true: whitelist, false: blacklist)

data.userAgeMin

integer

Targeting: Age range from

data.userAgeMax

integer

Targeting: Age range to

data.connectionTypes

array

Targeting: Connection types list

data.clickedInventoryCategories

array

Сlicked Inventory Categories

data.deviceCarrier

array

Targeting: List of network operators.

data.deviceCarrierIsInclude

boolean

Targeting: List of network operators type (true: whitelist, false: blacklist)

data.OS

array

Targeting: The operating system of user's device

data.OSIsInclude

boolean

Targeting: The operating system of user's device list type (true: whitelist, false: blacklist)

data.browser

array

Targeting: The user's browsers list

data.browserIsInclude

boolean

Targeting: The user's browsers list type (true: whitelist, false: blacklist)

data.deviceLanguage

array

Targeting: The languages of user's browser

data.deviceLanguageIsInclude

boolean

Targeting: The languages of user's browser list type (true: whitelist, false: blacklist)

data.spentDailyLimit

integer

Daily spent limit

data.spentTotalLimit

integer

Total spent limit

data.impressionsDailyLimit

integer

Daily impressions limit

data.impressionsTotalLimit

integer

Total impressions limit

data.clicksDailyLimit

integer

Daily clicks limit

data.clicksTotalLimit

integer

Total clicks limit

data.budgetUse

integer

Distribution: pacer, fast pacer - Evenly distribution fast - ASAP distribution

data.allSources

boolean

Inventory: Use all SSP endpoints

data.cpm

float

cpm

data.adaptiveCpm

boolean

adaptiveCpm

data.useCpm

boolean

use cpm

data.googleAnalyticsTrackingCode

string

Google Analytics tracking code - PUSH Campaigns

data.dynamicTargeting

array

SmartCPC: Dynamic targeting - only for CPC Pricing model

data.subscriptionAge

array

Subscription Age - only for CPC Pricing model

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.extendedStatus

string

Campaign extended status

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.deletedAt

datetime

Date of deletion

data.pretarget

int

pretarget

data.pretargets

array

pretargets

data.audiences

array

audiences

4.4.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 7,
        "userId": 12,
        "isActive": true,
        "isRunning": false,
        "type": "native",
        "name": "Updated Campaign #3",
        "isRewarded": false,
        "isDesktopWeb": true,
        "isMobileApp": true,
        "isMobileWeb": true,
        "isSmartphone": false,
        "isTablet": true,
        "isCTV": true,
        "isDOOH": true,
        "aDomain": "anderson.net",
        "dateStart": "2024-05-28",
        "dateEnd": "2025-10-12",
        "geoCountries": [],
        "geoCountriesIsInclude": true,
        "geoRegions": [],
        "geoRegionsIsInclude": true,
        "geoCities": [],
        "geoCitiesIsInclude": true,
        "contentCategories": [],
        "contentCategoriesIsInclude": true,
        "userAgeMin": 0,
        "userAgeMax": 0,
        "connectionTypes": [
            "wifi"
        ],
        "clickedInventoryCategories": [],
        "deviceCarrier": [],
        "deviceCarrierIsInclude": true,
        "OS": [],
        "OSIsInclude": true,
        "browser": [],
        "browserIsInclude": true,
        "deviceLanguage": [],
        "deviceLanguageIsInclude": true,
        "spentDailyLimit": 355,
        "spentTotalLimit": 4374,
        "impressionsDailyLimit": 272968,
        "impressionsTotalLimit": 400000,
        "clicksDailyLimit": 0,
        "clicksTotalLimit": 0,
        "budgetUse": "fast",
        "allSources": true,
        "cpm": 0,
        "adaptiveCpm": false,
        "useCpm": false,
        "googleAnalyticsTrackingCode": null,
        "dynamicTargeting": [],
        "subscriptionAge": [],
        "frequencyType": "user",
        "frequency": 0,
        "frequencyCap": 1,
        "frequencyPeriod": 1,
        "extendedStatus": "Low Balance",
        "createdAt": "2025-03-26",
        "updatedAt": "2025-03-26",
        "deletedAt": null,
        "pretarget": null,
        "pretargets": [],
        "audiences": []
    }
}

4.5. Delete a Custom Campaign

A `DELETE` request will delete campaign.

4.5.1. HTTP Request

URL

DELETE api/campaigns/8 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJkMzRUUEZFZHNyNTdtNXhvIiwic3ViIjoiMTMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.uvI7U6RFqGQK1clXcRk0fleCsq_lvacMJDD0pO9ZQeI
Content-type: application/x-www-form-urlencoded
DATA
{}

4.5.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/8' -i -X DELETE \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJkMzRUUEZFZHNyNTdtNXhvIiwic3ViIjoiMTMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.uvI7U6RFqGQK1clXcRk0fleCsq_lvacMJDD0pO9ZQeI' \
                -H 'Content-type: application/x-www-form-urlencoded' \
    -d '{}'

4.5.3. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{}

5. Upload media

5.1. Store Image

A `POST` request will upload image

5.1.1. Request Body

Path Type Description Required

media_assets

file

Array of files to upload

+

5.1.2. HTTP Request

URL

POST api/media-asset/upload/image HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJYeXlTcTFvUmE3NjR1cEV6Iiwic3ViIjoiNDIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.NISb-lyOxl7wwZHgT13GXpckbFNUinHolyr49lIlObg
DATA
{
    "media_assets": [
        <Binary file>
    ]
}

5.1.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/media-asset/upload/image' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJYeXlTcTFvUmE3NjR1cEV6Iiwic3ViIjoiNDIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.NISb-lyOxl7wwZHgT13GXpckbFNUinHolyr49lIlObg' \
    -d '{
    "media_assets": [
        <Binary file>
    ]
}'

5.1.4. Response Body

Path Type Description

message

string

Result message

data.*.id

integer

Media id

data.*.userId

integer

User Id

data.*.mediaType

string

Media type (html, image, video)

data.*.originName

string

Original file name

data.*.name

string

Uploaded file name

data.*.extension

string

Uploaded file extension

data.*.url

string

Uploaded file url

data.*.width

integer

Uploaded file image width

data.*.height

integer

Uploaded file image height

data.*.weight

integer

Uploaded file size kB

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

5.1.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "MediaAsset created.",
    "data": [
        {
            "id": 20,
            "userId": 42,
            "mediaType": "image",
            "originName": "test-image.png",
            "name": "test-image.png",
            "extension": "png",
            "url": "\/storage\/test-image.png",
            "width": 10,
            "height": 10,
            "weight": 91,
            "createdAt": "2025-03-26 09:53:39",
            "updatedAt": "2025-03-26 09:53:39"
        }
    ]
}

5.2. Store video

A `POST` request will upload video

5.2.1. Request Body

Path Type Description Required

media_assets

file

Array of files to upload

+

5.2.2. HTTP Request

URL

POST api/media-asset/upload/video HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJXRDNmcVRUSlZ6c3BQZmNCIiwic3ViIjoiNDMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.R7Op8cg9mbOyhcAGjIEa3WCQtx3X5HDq31BhXjiec_8
DATA
{
    "media_assets": [
        <Binary file>
    ]
}

5.2.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/media-asset/upload/video' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJXRDNmcVRUSlZ6c3BQZmNCIiwic3ViIjoiNDMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.R7Op8cg9mbOyhcAGjIEa3WCQtx3X5HDq31BhXjiec_8' \
    -d '{
    "media_assets": [
        <Binary file>
    ]
}'

5.2.4. Response Body

Path Type Description

message

string

Result message

data.*.id

integer

Media id

data.*.userId

integer

User Id

data.*.mediaType

string

Media type (html, image, video)

data.*.originName

string

Original file name

data.*.name

string

Uploaded file name

data.*.extension

string

Uploaded file extension

data.*.url

string

Uploaded file url

data.*.width

integer

Uploaded file image width

data.*.height

integer

Uploaded file image height

data.*.weight

integer

Uploaded file size kB

data.*.mimeType

string

Video mime type

data.*.bitrate

integer

Video bitrate

data.*.duration

integer

Video duration (in seconds)

data.*.durationTime

string

Video duration (in text format)

data.*.playtime

integer

Video playtime

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

5.2.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "MediaAsset created.",
    "data": [
        {
            "id": 21,
            "userId": 43,
            "mediaType": "video",
            "originName": "test-video.mp4",
            "name": "test-video.mp4",
            "extension": "mp4",
            "url": "\/storage\/test-video.mp4",
            "width": 320,
            "height": 240,
            "weight": 5312,
            "mimeType": "video\/quicktime",
            "bitrate": 201493,
            "duration": 0,
            "durationTime": "00:00:00",
            "playtime": "00:00:00",
            "createdAt": "2025-03-26 09:53:40",
            "updatedAt": "2025-03-26 09:53:40"
        }
    ]
}

5.3. Store HTML

A `POST` request will upload HTML

5.3.1. Request Body

Path Type Description Required

media_assets

file

Array of files to upload

+

5.3.2. HTTP Request

URL

POST api/media-asset/upload/html HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJyRGFyR1E1VlV4UmRWZnh0Iiwic3ViIjoiNDQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.s86KfFayxSx6RUIG6B3CFavpXpDTsIDpBdv_ixoc_1Q
DATA
{
    "media_assets": [
        <Binary file>
    ]
}

5.3.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/media-asset/upload/html' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJyRGFyR1E1VlV4UmRWZnh0Iiwic3ViIjoiNDQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.s86KfFayxSx6RUIG6B3CFavpXpDTsIDpBdv_ixoc_1Q' \
    -d '{
    "media_assets": [
        <Binary file>
    ]
}'

5.3.4. Response Body

Path Type Description

message

string

Result message

data.*.id

integer

Media id

data.*.userId

integer

User Id

data.*.mediaType

string

Media type (html, image, video)

data.*.originName

string

Original file name

data.*.name

string

Uploaded file name

data.*.extension

string

Uploaded file extension

data.*.url

string

Uploaded file url

data.*.width

integer

Uploaded file image width

data.*.height

integer

Uploaded file image height

data.*.weight

integer

Uploaded file size kB

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

5.3.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "MediaAsset created.",
    "data": [
        {
            "id": 22,
            "userId": 44,
            "mediaType": "html",
            "originName": "test-html.zip",
            "name": "TEST\/index.html",
            "extension": "zip",
            "url": "\/storage\/TEST\/index.html",
            "width": 0,
            "height": 0,
            "weight": 0,
            "createdAt": "2025-03-26 09:53:40",
            "updatedAt": "2025-03-26 09:53:40"
        }
    ]
}

5.4. Store filter list

A `POST` request will upload video

5.4.1. HTTP Request

URL

POST api/parsefile HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJKTzVrWkFPVlpzb2g0UEZDIiwic3ViIjoiNDUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.VIEJxcXyTXLg0_uCwvK1QYIhLRBt-41vZVmcOEJQlVY
DATA
{
    "file": <Binary file>
}

5.4.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/parsefile' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJKTzVrWkFPVlpzb2g0UEZDIiwic3ViIjoiNDUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.VIEJxcXyTXLg0_uCwvK1QYIhLRBt-41vZVmcOEJQlVY' \
    -d '{
    "file": <Binary file>
}'

5.4.3. Response Body

Path Type Description

message

string

Result message

items

array

List array items

fileName

string

File name

countItems

integer

Count items

5.4.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "success",
    "items": [
        "test.com"
    ],
    "fileName": "1742982820_test-filter.csv",
    "countItems": 0
}

6. Creatives

6.1. Creatives list

A `GET` request will return a list of an creatives.

6.1.1. HTTP Request

URL

GET api/creatives HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJwOGJZOHhoR01LR1NPRFhvIiwic3ViIjoiMjUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.TJZ53TGW8Ghgf4UfsmabfMzwidxT3u7tPovvz2lJI9M
DATA
{}

6.1.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJwOGJZOHhoR01LR1NPRFhvIiwic3ViIjoiMjUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.TJZ53TGW8Ghgf4UfsmabfMzwidxT3u7tPovvz2lJI9M' \
    -d '{}'

6.1.3. Response Body

Path Type Description

data.*.id

integer

Creative Id

data.*.userId

integer

User Id

data.*.isActive

boolean

Creative status

data.*.approved

string

Creative approval status (approved, pending, disapproved)

data.*.creativeType

string

Creative type: banner, native, video, audio

data.*.name

string

Creative name

data.*.frequencyType

string

Identify the user to limit the number of the ad shows for the specific user (user, ip). Required if frequency is on.

data.*.frequency

string

Frequency on/off

data.*.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period". Required if frequency is on.

data.*.frequencyPeriod

integer

Frequency period in days (min-1,max-3). Required if frequency is on.

data.*.bidPrice

float

CPM

data.*.autoresize

boolean

autoresize

data.*.adaptiveCpm

bool

adaptiveCpm

data.*.size

string

Image width and height

data.*.weight

string

File size

data.*.folderId

string

Folder Id

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

data.*.pendingAt

datetime

Date of pending start

data.*.deletedAt

datetime

Date of deletion

data.*.media.id

integer

Media Id

data.*.media.userId

string

User Id

data.*.media.mediaType

string

Media type (html, image, video)

data.*.media.originName

string

Uploaded file original name

data.*.media.name

string

Uploaded file name

data.*.media.extension

string

Uploaded file extention

data.*.media.url

string

Uploaded file URL

data.*.media.width

integer

Uploaded file image width

data.*.media.height

integer

Uploaded file image height

data.*.media.weight

integer

Uploaded file size

data.*.relation.banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

data.*.relation.banner.admBody

string

Third-party tag

data.*.relation.banner.bannerType

String

Banner type (banner,inBannerVideo)

data.*.relation.banner.clickUrl

string

Click URL

data.*.relation.banner.width

integer

Banner width

data.*.relation.banner.height

integer

Banner height

data.*.relation.banner.childrenCreative

string

childrenCreative

data.*.relation.banner.statusChildrenCreative

string

statusChildrenCreative

data.*.relation.banner.main

boolean

Main creative

data.*.status

string

Status

data.*.relation.native.smallImageId

integer

Logo media id

data.*.relation.native.largeImageId

integer

Image media id

data.*.relation.native.smallImage.id

integer

Logo media id

data.*.relation.native.smallImage.folderId

string

Folder id

data.*.relation.native.smallImage.userId

integer

User id

data.*.relation.native.smallImage.width

string

width

data.*.relation.native.smallImage.height

string

height

data.*.relation.native.smallImage.name

string

name

data.*.relation.native.smallImage.url

string

url

data.*.relation.native.smallImage.href

string

href

data.*.relation.native.smallImage.originName

string

originName

data.*.relation.native.smallImage.path

string

path

data.*.relation.native.smallImage.extension

string

extension

data.*.relation.native.smallImage.mediaType

string

mediaType

data.*.relation.native.smallImage.createdAt

string

createdAt

data.*.relation.native.smallImage.updatedAt

string

updatedAt

data.*.relation.native.smallImage.deletedAt

string

updatedAt

data.*.relation.native.smallImage.weight

string

weight

data.*.relation.native.largeImage.id

integer

Image media id

data.*.relation.native.largeImage.folderId

string

Folder id

data.*.relation.native.largeImage.userId

integer

User id

data.*.relation.native.largeImage.width

string

width

data.*.relation.native.largeImage.height

string

height

data.*.relation.native.largeImage.name

string

name

data.*.relation.native.largeImage.url

string

url

data.*.relation.native.largeImage.href

string

href

data.*.relation.native.largeImage.originName

string

originName

data.*.relation.native.largeImage.path

string

path

data.*.relation.native.largeImage.extension

string

extension

data.*.relation.native.largeImage.mediaType

string

mediaType

data.*.relation.native.largeImage.createdAt

string

createdAt

data.*.relation.native.largeImage.updatedAt

string

updatedAt

data.*.relation.native.largeImage.deletedAt

string

updatedAt

data.*.relation.native.largeImage.weight

string

weight

data.*.relation.native.assetDataDesc

string

Ad text

data.*.relation.native.assetTitle

string

Ad title

data.*.relation.native.assetDataSponsored

string

Brand name

data.*.relation.native.assetCtaText

string

CTA button text

data.*.relation.native.clickUrl

string

Click URL

data.*.relation.native.displayUrl

string

Display URL

data.*.relation.native.impTracker

string

Impression Tracker

data.*.relation.video.sizes

string

Player size

data.*.relation.video.admBody

string

Third-party tag

data.*.relation.video.mimeType

array

MIME types ("[video/mpeg, video/mp4, video/quicktime, video/x-flv, application/x-shockwave-flash, application/javascript, video/x-ms-wmv, video/webm]")

data.*.relation.video.width

integer

Video width

data.*.relation.video.height

integer

Video height

data.*.relation.video.duration

integer

Video duration

data.*.relation.video.clickUrl

string

Click URL

data.*.relation.video.partyTagFormat

integer

3 party tag format (0-NO VPAID, 1-VPAID 1, 2-VPAID 2, 3-ALL VPAID)

data.*.relation.video.autoStoreEndCard

boolean

autoStoreEndCard

data.*.relation.video.autoStoreEndCardOption

string

autoStoreEndCardOption

meta.pagination.total

integer

Pagination: total items count

meta.pagination.count

integer

Pagination: page items count

meta.pagination.per_page

integer

Pagination: items per page

meta.pagination.current_page

integer

Pagination: current page number

meta.pagination.total_pages

integer

Pagination: total pages count

meta.pagination.links

object

Pagination links

6.1.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": [
        {
            "id": 8,
            "userId": 25,
            "isActive": 0,
            "approved": "pending",
            "creativeType": "banner",
            "name": "Banner creative #1",
            "frequencyType": "ip",
            "frequency": 0,
            "frequencyCap": 6,
            "frequencyPeriod": 1,
            "bidPrice": "1.69",
            "autoresize": 0,
            "adaptiveCpm": false,
            "size": "375 x 270",
            "weight": "0.12 MB",
            "folderId": null,
            "createdAt": "2025-03-26 09:53:37",
            "updatedAt": "2025-03-26 09:53:37",
            "pendingAt": null,
            "deletedAt": null,
            "media": {
                "id": 8,
                "userId": 25,
                "mediaType": "image",
                "originName": "image.jpg",
                "name": "25_521313a55ca0ac073fa706a64c4c0034.jpg",
                "extension": "jpg",
                "url": "http:\/\/www.johns.com\/ut-rerum-assumenda-molestiae-non-delectus-quae-delectus-modi25_521313a55ca0ac073fa706a64c4c0034.jpg",
                "width": 350,
                "height": 349,
                "weight": 128207
            },
            "relation": {
                "banner": {
                    "apiFramework": 0,
                    "admBody": "<a target=\"_blank\" href=\"http:\/\/www.nolan.org\/repudiandae-tenetur-suscipit-tempore-beatae\" ><img src=\"http:\/\/www.bechtelar.com\/similique-voluptatem-voluptas-ratione-quia\/10.jpg\"\/><\/a>",
                    "bannerType": "banner",
                    "clickUrl": "http:\/\/www.emmerich.com\/",
                    "width": 375,
                    "height": 270,
                    "childrenCreative": null,
                    "statusChildrenCreative": [],
                    "main": 1
                }
            },
            "status": "pending"
        },
        {
            "id": 9,
            "userId": 25,
            "isActive": 1,
            "approved": "pending",
            "creativeType": "native",
            "name": "Native creative #1",
            "frequencyType": "ip",
            "frequency": 0,
            "frequencyCap": 2,
            "frequencyPeriod": 1,
            "bidPrice": "17.42",
            "autoresize": 0,
            "adaptiveCpm": false,
            "size": "471 x 201",
            "weight": "0.00 MB",
            "folderId": null,
            "createdAt": "2025-03-26 09:53:37",
            "updatedAt": "2025-03-26 09:53:37",
            "pendingAt": null,
            "deletedAt": null,
            "media": {
                "id": 9,
                "userId": 25,
                "mediaType": "image",
                "originName": "image.jpg",
                "name": "25_521313a55ca0ac073fa706a64c4c0034.jpg",
                "extension": "jpg",
                "url": "http:\/\/kertzmann.com\/esse-sequi-voluptas-asperiores-velit25_521313a55ca0ac073fa706a64c4c0034.jpg",
                "width": 246,
                "height": 360,
                "weight": 345595
            },
            "relation": {
                "native": {
                    "smallImageId": 9,
                    "largeImageId": 10,
                    "smallImage": {
                        "id": 9,
                        "folderId": null,
                        "userId": 25,
                        "width": 246,
                        "height": 360,
                        "name": "25_521313a55ca0ac073fa706a64c4c0034.jpg",
                        "url": "http:\/\/kertzmann.com\/esse-sequi-voluptas-asperiores-velit25_521313a55ca0ac073fa706a64c4c0034.jpg",
                        "href": null,
                        "originName": "image.jpg",
                        "path": null,
                        "extension": "jpg",
                        "mediaType": "image",
                        "createdAt": "2025-03-26T09:53:37.000000Z",
                        "updatedAt": "2025-03-26T09:53:37.000000Z",
                        "deletedAt": null,
                        "weight": 345595
                    },
                    "largeImage": {
                        "id": 10,
                        "folderId": null,
                        "userId": 25,
                        "width": 471,
                        "height": 201,
                        "name": "25_521313a55ca0ac073fa706a64c4c0034.jpg",
                        "url": "http:\/\/fisher.com\/25_521313a55ca0ac073fa706a64c4c0034.jpg",
                        "href": null,
                        "originName": "image.jpg",
                        "path": null,
                        "extension": "jpg",
                        "mediaType": "image",
                        "createdAt": "2025-03-26T09:53:37.000000Z",
                        "updatedAt": "2025-03-26T09:53:37.000000Z",
                        "deletedAt": null,
                        "weight": 327600
                    },
                    "assetDataDesc": "Similique qui et et hic.",
                    "assetTitle": "Officiis hic qui et est.",
                    "assetDataSponsored": "Minima et et commodi labore non.",
                    "assetCtaText": "Ea nulla et cum.",
                    "clickUrl": "http:\/\/christiansen.com\/et-sit-in-sunt-omnis-placeat-culpa-iure",
                    "displayUrl": "https:\/\/gulgowski.biz\/perspiciatis-et-voluptates-modi-numquam-placeat-dolorem.html",
                    "impTracker": null
                }
            },
            "status": "pending"
        },
        {
            "id": 10,
            "userId": 25,
            "isActive": 1,
            "approved": "pending",
            "creativeType": "video",
            "name": "Video creative #1",
            "frequencyType": "user",
            "frequency": 0,
            "frequencyCap": 5,
            "frequencyPeriod": 1,
            "bidPrice": "13.61",
            "autoresize": 0,
            "adaptiveCpm": false,
            "size": "635 x 146",
            "weight": "0.10 MB",
            "folderId": null,
            "createdAt": "2025-03-26 09:53:37",
            "updatedAt": "2025-03-26 09:53:37",
            "pendingAt": null,
            "deletedAt": null,
            "media": {
                "id": 11,
                "userId": 25,
                "mediaType": "video",
                "originName": "video.mp4",
                "name": "25_521313a55ca0ac073fa706a64c4c0034.mp4",
                "extension": "mp4",
                "url": "https:\/\/effertz.com\/autem-perferendis-perspiciatis-atque-quod.html25_521313a55ca0ac073fa706a64c4c0034.mp4",
                "width": 143,
                "height": 399,
                "weight": 104613
            },
            "relation": {
                "video": {
                    "sizes": "x-large",
                    "admBody": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"2.0\">\n<Ad id=\"[HASH]\">\n    <InLine>\n        <AdSystem>DSP<\/AdSystem>\n        <AdTitle>Smartyads<\/AdTitle>\n        <Description>RTB<\/Description>\n        <Creatives>\n            <Creative AdID=\"572\">\n                <Linear>\n                    <Duration>00:00:09<\/Duration>\n                    <VideoClicks>\n                        <ClickThrough><![CDATA[https:\/\/picsum.photos\/]]><\/ClickThrough>\n                    <\/VideoClicks>\n                    <MediaFiles>\n                        <MediaFile delivery=\"streaming\" type=\"video\/quicktime\" width=\"640\" height=\"360\"><![CDATA[http:\/\/72.mp4]]><\/MediaFile>\n                    <\/MediaFiles>\n                <\/Linear>\n            <\/Creative>\n        <\/Creatives>\n    <\/InLine>\n<\/Ad>\n<\/VAST>",
                    "mimeType": [
                        "video\/webm"
                    ],
                    "width": 635,
                    "height": 146,
                    "duration": 4,
                    "clickUrl": "http:\/\/www.bosco.org\/repudiandae-totam-iure-laborum-et-consequuntur-soluta-iure",
                    "partyTagFormat": 0,
                    "autoStoreEndCard": 0,
                    "autoStoreEndCardOption": "appStore"
                }
            },
            "status": "pending"
        }
    ],
    "meta": {
        "pagination": {
            "total": 3,
            "count": 3,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 1,
            "links": []
        }
    }
}

6.2. Get by ID (Banner creative)

A `GET` request with a path parameter of the id will return the creative with that id.

6.2.1. HTTP Request

URL

GET api/creatives/11 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJSeG5sOXZySnZyZGt4NGhtIiwic3ViIjoiMjYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.atpIJFE0YSojvAUl79p8AUUO6D_NLwceNJTd_6yL3_k
DATA
{}

6.2.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives/11' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJSeG5sOXZySnZyZGt4NGhtIiwic3ViIjoiMjYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.atpIJFE0YSojvAUl79p8AUUO6D_NLwceNJTd_6yL3_k' \
    -d '{}'

6.2.3. Response Body

Path Type Description

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.media.id

integer

Media Id

data.media.userId

string

User Id

data.media.mediaType

string

Media type (html, image, video)

data.media.originName

string

Uploaded file original name

data.media.name

string

Uploaded file name

data.media.extension

string

Uploaded file extention

data.media.url

string

Uploaded file URL

data.media.width

integer

Uploaded file image width

data.media.height

integer

Uploaded file image height

data.media.weight

integer

Uploaded file size

data.media.modifiedUrl

any

data.relation.banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

data.relation.banner.admBody

string

Third-party tag

data.relation.banner.bannerType

String

Banner type (banner,inBannerVideo)

data.relation.banner.clickUrl

string

Click URL

data.relation.banner.width

integer

Banner width

data.relation.banner.height

integer

Banner height

data.sizes

string

size

6.2.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 11,
        "userId": 26,
        "isActive": 0,
        "approved": "pending",
        "creativeType": "banner",
        "name": "Banner creative #2",
        "frequencyType": "user",
        "frequency": 0,
        "frequencyCap": 7,
        "frequencyPeriod": 1,
        "bidPrice": "18.08",
        "autoresize": 0,
        "adaptiveCpm": false,
        "size": "587 x 269",
        "weight": "0.32 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:37",
        "updatedAt": "2025-03-26 09:53:37",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "banner": {
                "apiFramework": 0,
                "admBody": "<a target=\"_blank\" href=\"http:\/\/www.cummerata.com\/aut-itaque-praesentium-quis-ad-id-voluptatem-et-eum\" ><img src=\"http:\/\/dach.com\/sed-deleniti-fugit-modi-nemo\/10.jpg\"\/><\/a>",
                "bannerType": "banner",
                "clickUrl": "https:\/\/torphy.net\/quidem-aliquid-culpa-dignissimos-adipisci.html",
                "width": 587,
                "height": 269
            }
        },
        "sizes": []
    }
}

6.3. Get by ID (Native creative)

A `GET` request with a path parameter of the id will return the creative with that id.

6.3.1. HTTP Request

URL

GET api/creatives/12 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJTNjJsSlNBNjJlcFR0ZGhrIiwic3ViIjoiMjciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.5UoPzIgLAsU5X3EpGTtYLBPFFZOjyG3q-ovNaimA_A4
DATA
{}

6.3.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives/12' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJTNjJsSlNBNjJlcFR0ZGhrIiwic3ViIjoiMjciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.5UoPzIgLAsU5X3EpGTtYLBPFFZOjyG3q-ovNaimA_A4' \
    -d '{}'

6.3.3. Response Body

Path Type Description

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.media.id

integer

Media Id

data.media.userId

string

User Id

data.media.mediaType

string

Media type (html, image, video)

data.media.originName

string

Uploaded file original name

data.media.name

string

Uploaded file name

data.media.extension

string

Uploaded file extention

data.media.url

string

Uploaded file URL

data.media.width

integer

Uploaded file image width

data.media.height

integer

Uploaded file image height

data.media.weight

integer

Uploaded file size

data.media.modifiedUrl

any

data.relation.native.smallImageId

integer

Logo media id

data.relation.native.largeImageId

integer

Image media id

data.relation.native.smallImage.id

integer

Logo media id

data.relation.native.smallImage.folderId

string

Folder id

data.relation.native.smallImage.userId

integer

User id

data.relation.native.smallImage.width

string

width

data.relation.native.smallImage.height

string

height

data.relation.native.smallImage.name

string

name

data.relation.native.smallImage.url

string

url

data.relation.native.smallImage.href

string

href

data.relation.native.smallImage.originName

string

originName

data.relation.native.smallImage.path

string

path

data.relation.native.smallImage.extension

string

extension

data.relation.native.smallImage.mediaType

string

mediaType

data.relation.native.smallImage.createdAt

string

createdAt

data.relation.native.smallImage.updatedAt

string

updatedAt

data.relation.native.smallImage.deletedAt

string

updatedAt

data.relation.native.smallImage.weight

string

weight

data.relation.native.largeImage.id

integer

Image media id

data.relation.native.largeImage.folderId

string

Folder id

data.relation.native.largeImage.userId

integer

User id

data.relation.native.largeImage.width

string

width

data.relation.native.largeImage.height

string

height

data.relation.native.largeImage.name

string

name

data.relation.native.largeImage.url

string

url

data.relation.native.largeImage.href

string

href

data.relation.native.largeImage.originName

string

originName

data.relation.native.largeImage.path

string

path

data.relation.native.largeImage.extension

string

extension

data.relation.native.largeImage.mediaType

string

mediaType

data.relation.native.largeImage.createdAt

string

createdAt

data.relation.native.largeImage.updatedAt

string

updatedAt

data.relation.native.largeImage.deletedAt

string

updatedAt

data.relation.native.largeImage.weight

string

weight

data.relation.native.assetDataDesc

string

Ad text

data.relation.native.assetTitle

string

Ad title

data.relation.native.assetDataSponsored

string

Brand name

data.relation.native.assetCtaText

string

CTA button text

data.relation.native.clickUrl

string

Click URL

data.relation.native.displayUrl

string

Display URL

data.relation.native.impTracker

string

Impression tracker

data.sizes

string

size

6.3.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 12,
        "userId": 27,
        "isActive": 0,
        "approved": "pending",
        "creativeType": "native",
        "name": "Native creative #2",
        "frequencyType": "user",
        "frequency": 0,
        "frequencyCap": 8,
        "frequencyPeriod": 1,
        "bidPrice": "15.78",
        "autoresize": 0,
        "adaptiveCpm": false,
        "size": "159 x 375",
        "weight": "0.00 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:38",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "native": {
                "smallImageId": 13,
                "largeImageId": 14,
                "smallImage": {
                    "id": 13,
                    "folderId": null,
                    "userId": 27,
                    "width": 268,
                    "height": 312,
                    "name": "27_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "url": "http:\/\/baumbach.org\/nihil-aut-doloremque-quia-hic-voluptatem-quia.html27_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "href": null,
                    "originName": "image.jpg",
                    "path": null,
                    "extension": "jpg",
                    "mediaType": "image",
                    "createdAt": "2025-03-26T09:53:38.000000Z",
                    "updatedAt": "2025-03-26T09:53:38.000000Z",
                    "deletedAt": null,
                    "weight": 101809
                },
                "largeImage": {
                    "id": 14,
                    "folderId": null,
                    "userId": 27,
                    "width": 159,
                    "height": 375,
                    "name": "27_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "url": "http:\/\/www.kub.net\/27_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "href": null,
                    "originName": "image.jpg",
                    "path": null,
                    "extension": "jpg",
                    "mediaType": "image",
                    "createdAt": "2025-03-26T09:53:38.000000Z",
                    "updatedAt": "2025-03-26T09:53:38.000000Z",
                    "deletedAt": null,
                    "weight": 349226
                },
                "assetDataDesc": "Soluta iusto id ullam.",
                "assetTitle": "Et in unde inventore.",
                "assetDataSponsored": "Dolorum natus omnis quo animi quod quidem et.",
                "assetCtaText": "Fuga enim nostrum qui.",
                "clickUrl": "https:\/\/keebler.org\/qui-qui-earum-beatae-animi.html",
                "displayUrl": "http:\/\/www.cormier.com\/perspiciatis-dicta-ex-in-magnam-corporis-excepturi",
                "impTracker": null
            }
        },
        "sizes": []
    }
}

6.4. Get by ID (Video creative)

A `GET` request with a path parameter of the id will return the creative with that id.

6.4.1. HTTP Request

URL

GET api/creatives/13 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJvMGxONG5oUDEwZHdWa0RRIiwic3ViIjoiMjgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.sdnIulpCVsjJ6pQmenMCAFfauOl-hunL-AdMeCQzW8E
DATA
{}

6.4.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives/13' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJvMGxONG5oUDEwZHdWa0RRIiwic3ViIjoiMjgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.sdnIulpCVsjJ6pQmenMCAFfauOl-hunL-AdMeCQzW8E' \
    -d '{}'

6.4.3. Response Body

Path Type Description

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.media.id

integer

Media Id

data.media.userId

string

User Id

data.media.mediaType

string

Media type (html, image, video)

data.media.originName

string

Uploaded file original name

data.media.name

string

Uploaded file name

data.media.extension

string

Uploaded file extention

data.media.url

string

Uploaded file URL

data.media.width

integer

Uploaded file image width

data.media.height

integer

Uploaded file image height

data.media.weight

integer

Uploaded file size

data.media.modifiedUrl

any

data.relation.video.sizes

string

Player size

data.relation.video.admBody

string

Third-party tag

data.relation.video.mimeType

array

MIME types

data.relation.video.width

integer

Video width

data.relation.video.height

integer

Video height

data.relation.video.duration

integer

Video duration

data.relation.video.clickUrl

string

Click URL

data.relation.video.partyTagFormat

integer

3 party tag format (0-NO VPAID, 1-VPAID 1, 2-VPAID 2, 3-ALL VPAID)

data.relation.video.autoStoreEndCard

boolean

autoStoreEndCard

data.relation.video.autoStoreEndCardOption

string

autoStoreEndCardOption

data.sizes

string

size

6.4.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 13,
        "userId": 28,
        "isActive": 1,
        "approved": "pending",
        "creativeType": "video",
        "name": "Video creative #2",
        "frequencyType": "user",
        "frequency": 0,
        "frequencyCap": 8,
        "frequencyPeriod": 1,
        "bidPrice": "2.99",
        "autoresize": 0,
        "adaptiveCpm": false,
        "size": "233 x 217",
        "weight": "0.15 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:38",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "video": {
                "sizes": "small",
                "admBody": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"2.0\">\n<Ad id=\"[HASH]\">\n    <InLine>\n        <AdSystem>DSP<\/AdSystem>\n        <AdTitle>Smartyads<\/AdTitle>\n        <Description>RTB<\/Description>\n        <Creatives>\n            <Creative AdID=\"572\">\n                <Linear>\n                    <Duration>00:00:09<\/Duration>\n                    <VideoClicks>\n                        <ClickThrough><![CDATA[https:\/\/picsum.photos\/]]><\/ClickThrough>\n                    <\/VideoClicks>\n                    <MediaFiles>\n                        <MediaFile delivery=\"streaming\" type=\"video\/quicktime\" width=\"640\" height=\"360\"><![CDATA[http:\/\/72.mp4]]><\/MediaFile>\n                    <\/MediaFiles>\n                <\/Linear>\n            <\/Creative>\n        <\/Creatives>\n    <\/InLine>\n<\/Ad>\n<\/VAST>",
                "mimeType": [
                    "application\/x-shockwave-flash"
                ],
                "width": 233,
                "height": 217,
                "duration": 9,
                "clickUrl": "http:\/\/feeney.info\/eum-quam-optio-perferendis-expedita-quis-ut.html",
                "partyTagFormat": 0,
                "autoStoreEndCard": 0,
                "autoStoreEndCardOption": "appStore"
            }
        },
        "sizes": []
    }
}

6.5. Create a Custom Banner Creative with Third-party tag

A `POST` request will create new creative.

6.5.1. Request Body

Path Type Description Required

name

string

Creative name

+

creativeType

string

Creative type: banner, native, video, audio

+

frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

frequency

boolean

Frequency on/off.

frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

bidPrice

float

CPM

+

banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

banner.width

integer

Banner width

+

banner.height

integer

Banner height

+

banner.admBody

string

Third-party tag

+

categories.IAB1

array

Categories (required if subCategories is empty)

+

subCategories.IAB1

array

SubCategories (required if categories is empty)

+

6.5.2. HTTP Request

URL

POST api/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJJRVVOUG1Gd2hmZjBOOWJHIiwic3ViIjoiMjkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.a-iSQOvtn52odVHGJb_FJXPxXTBbZNg7LKTW5GLTz5Q
DATA
{
    "name": "Banner creative #3",
    "creativeType": "banner",
    "frequencyType": "user",
    "frequencyCap": 1,
    "frequency": 1,
    "frequencyPeriod": 1,
    "bidPrice": 0.5,
    "banner": {
        "apiFramework": 0,
        "width": 320,
        "height": 200,
        "admBody": "<iframe src=\"url.to.script\"><\/iframe>"
    },
    "categories": {
        "IAB1": true
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    }
}

6.5.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJJRVVOUG1Gd2hmZjBOOWJHIiwic3ViIjoiMjkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.a-iSQOvtn52odVHGJb_FJXPxXTBbZNg7LKTW5GLTz5Q' \
    -d '{
    "name": "Banner creative #3",
    "creativeType": "banner",
    "frequencyType": "user",
    "frequencyCap": 1,
    "frequency": 1,
    "frequencyPeriod": 1,
    "bidPrice": 0.5,
    "banner": {
        "apiFramework": 0,
        "width": 320,
        "height": 200,
        "admBody": "<iframe src=\"url.to.script\"><\/iframe>"
    },
    "categories": {
        "IAB1": true
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    }
}'

6.5.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.relation.banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

data.relation.banner.admBody

string

Third-party tag

data.relation.banner.bannerType

String

Banner type (banner,inBannerVideo)

data.relation.banner.clickUrl

string

Click URL

data.relation.banner.width

integer

Banner width

data.relation.banner.height

integer

Banner height

data.sizes

string

size

6.5.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Creative created.",
    "data": {
        "id": 14,
        "userId": 29,
        "isActive": null,
        "approved": null,
        "creativeType": "banner",
        "name": "Banner creative #3",
        "frequencyType": "user",
        "frequency": 1,
        "frequencyCap": 1,
        "frequencyPeriod": 1,
        "bidPrice": 0.5,
        "autoresize": null,
        "adaptiveCpm": null,
        "size": "320 x 200",
        "weight": "0.00 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:38",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "banner": {
                "apiFramework": 0,
                "admBody": "<iframe src=\"url.to.script\"><\/iframe>",
                "bannerType": null,
                "clickUrl": null,
                "width": 320,
                "height": 200
            }
        },
        "sizes": []
    }
}

6.6. Create a Custom Banner Creative with Media image

A `POST` request will create new creative.

6.6.1. Request Body

Path Type Description Required

name

string

Creative name

+

creativeType

string

Creative type: banner, native, video, audio

+

mediaId

array

Media image Id

+

frequency

boolean

Frequency on/off.

bidPrice

float

CPM

+

banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

banner.width

integer

Banner width

+

banner.height

integer

Banner height

+

banner.clickUrl

string

Click URL

+

subCategories.IAB1

array

SubCategories (required if categories is empty)

+

categories.IAB1

array

Categories (required if subCategories is empty)

+

6.6.2. HTTP Request

URL

POST api/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJEeFFhTjdkOE13YXF1bDFjIiwic3ViIjoiMzAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.bsCk9msyvlTEy53C40ihqyUmoCPFbbshAmAGLVe85i4
DATA
{
    "name": "Banner creative #4",
    "creativeType": "banner",
    "mediaId": 16,
    "frequency": 0,
    "bidPrice": 0.5,
    "banner": {
        "apiFramework": 0,
        "width": 320,
        "height": 200,
        "clickUrl": "http:\/\/www.schmitt.com\/quidem-ad-hic-provident-et-et-id"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}

6.6.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJEeFFhTjdkOE13YXF1bDFjIiwic3ViIjoiMzAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.bsCk9msyvlTEy53C40ihqyUmoCPFbbshAmAGLVe85i4' \
    -d '{
    "name": "Banner creative #4",
    "creativeType": "banner",
    "mediaId": 16,
    "frequency": 0,
    "bidPrice": 0.5,
    "banner": {
        "apiFramework": 0,
        "width": 320,
        "height": 200,
        "clickUrl": "http:\/\/www.schmitt.com\/quidem-ad-hic-provident-et-et-id"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}'

6.6.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.media.id

integer

Media Id

data.media.userId

string

User Id

data.media.mediaType

string

Media type (html, image, video)

data.media.originName

string

Uploaded file original name

data.media.name

string

Uploaded file name

data.media.extension

string

Uploaded file extention

data.media.url

string

Uploaded file URL

data.media.width

integer

Uploaded file image width

data.media.height

integer

Uploaded file image height

data.media.weight

integer

Uploaded file size

data.media.modifiedUrl

any

data.relation.banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

data.relation.banner.admBody

string

Third-party tag

data.relation.banner.bannerType

String

Banner type (banner,inBannerVideo)

data.relation.banner.clickUrl

string

Click URL

data.relation.banner.width

integer

Banner width

data.relation.banner.height

integer

Banner height

data.sizes

string

size

6.6.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Creative created.",
    "data": {
        "id": 15,
        "userId": 30,
        "isActive": null,
        "approved": null,
        "creativeType": "banner",
        "name": "Banner creative #4",
        "frequencyType": null,
        "frequency": 0,
        "frequencyCap": null,
        "frequencyPeriod": null,
        "bidPrice": 0.5,
        "autoresize": null,
        "adaptiveCpm": null,
        "size": "235 x 185",
        "weight": "0.34 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:38",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "banner": {
                "apiFramework": 0,
                "admBody": "<a target=\"_blank\" href=\"https:\/\/www.schmitt.com\/quidem-ad-hic-provident-et-et-id\" ><img src=\"http:\/\/powlowski.com\/repellendus-inventore-itaque-sunt-in30_f02e3793889205f8f6cf53decfef52e1.jpg\" crossorigin=\"anonymous\"\/><\/a>",
                "bannerType": null,
                "clickUrl": "https:\/\/www.schmitt.com\/quidem-ad-hic-provident-et-et-id",
                "width": 235,
                "height": 185
            }
        },
        "sizes": []
    }
}

6.7. Create a Custom Banner Creative with Rich Media Html

A `POST` request will create new creative.

6.7.1. Request Body

Path Type Description Required

name

string

Creative name

+

creativeType

string

Creative type: banner, native, video, audio

+

mediaId

array

HTML Media Id

+

frequency

boolean

Frequency on/off.

bidPrice

float

CPM

+

banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

banner.width

integer

Banner width

+

banner.height

integer

Banner height

+

subCategories.IAB1

array

SubCategories (required if categories is empty)

+

categories.IAB1

array

Categories (required if subCategories is empty)

+

6.7.2. HTTP Request

URL

POST api/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJ3bjExMXBLcG82VTA4cnpRIiwic3ViIjoiMzEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.9z68APq1u9FX5p67ED-Hhm05A_kfETqet3DKmFo6GV8
DATA
{
    "name": "Banner creative #5",
    "creativeType": "banner",
    "mediaId": 17,
    "frequency": 0,
    "bidPrice": 0.5,
    "banner": {
        "apiFramework": 3,
        "width": 320,
        "height": 200
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}

6.7.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJ3bjExMXBLcG82VTA4cnpRIiwic3ViIjoiMzEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.9z68APq1u9FX5p67ED-Hhm05A_kfETqet3DKmFo6GV8' \
    -d '{
    "name": "Banner creative #5",
    "creativeType": "banner",
    "mediaId": 17,
    "frequency": 0,
    "bidPrice": 0.5,
    "banner": {
        "apiFramework": 3,
        "width": 320,
        "height": 200
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}'

6.7.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.media.id

integer

Media Id

data.media.userId

string

User Id

data.media.mediaType

string

Media type (html, image, video)

data.media.originName

string

Uploaded file original name

data.media.name

string

Uploaded file name

data.media.extension

string

Uploaded file extention

data.media.url

string

Uploaded file URL

data.media.width

integer

Uploaded file image width

data.media.height

integer

Uploaded file image height

data.media.weight

integer

Uploaded file size

data.media.modifiedUrl

any

data.relation.banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

data.relation.banner.admBody

string

Third-party tag

data.relation.banner.bannerType

String

Banner type (banner,inBannerVideo)

data.relation.banner.clickUrl

string

Click URL

data.relation.banner.width

integer

Banner width

data.relation.banner.height

integer

Banner height

data.sizes

string

size

6.7.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Creative created.",
    "data": {
        "id": 16,
        "userId": 31,
        "isActive": null,
        "approved": null,
        "creativeType": "banner",
        "name": "Banner creative #5",
        "frequencyType": null,
        "frequency": 0,
        "frequencyCap": null,
        "frequencyPeriod": null,
        "bidPrice": 0.5,
        "autoresize": null,
        "adaptiveCpm": null,
        "size": "320 x 200",
        "weight": "0.15 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:38",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "banner": {
                "apiFramework": 3,
                "admBody": "<iframe src=\"http:\/\/www.bechtelar.com\/non-rerum-magni-officia.html31_f02e3793889205f8f6cf53decfef52e1\/index.html\"><\/iframe>",
                "bannerType": null,
                "clickUrl": null,
                "width": 320,
                "height": 200
            }
        },
        "sizes": []
    }
}

6.8. Create a Custom Native Creative

A `POST` request will create new creative.

6.8.1. Request Body

Path Type Description Required

name

string

Creative name

+

creativeType

string

Creative type: banner, native, video, audio

+

frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

frequency

boolean

Frequency on/off.

bidPrice

float

CPM

+

folderId

string

Folder Id

native.smallImageId

integer

Logo media id

native.largeImageId

integer

Image media id

+

native.assetDataDesc

string

Ad text

native.assetTitle

string

Ad title

native.assetDataSponsored

string

Brand name

native.assetCtaText

string

CTA button text

native.clickUrl

string

Click URL

+

native.displayUrl

string

Display URL

subCategories.IAB1

array

SubCategories (required if categories is empty)

+

categories.IAB1

array

Categories (required if subCategories is empty)

+

6.8.2. HTTP Request

URL

POST api/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJhTkxaVlB2Z2NpQ0FKd2xpIiwic3ViIjoiMzIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.O-HzDOZ6l96wuYRBC_U8jgTNUVnyGtCzqDIKQLyVqmE
DATA
{
    "name": "Native creative #3",
    "creativeType": "native",
    "frequencyType": "user",
    "frequencyCap": 1,
    "frequencyPeriod": 1,
    "frequency": 1,
    "bidPrice": 0.5,
    "folderId": null,
    "native": {
        "smallImageId": 18,
        "largeImageId": 18,
        "assetDataDesc": "Velit officiis.",
        "assetTitle": "Non ullam.",
        "assetDataSponsored": "Vitae quis neque a.",
        "assetCtaText": "A labore.",
        "clickUrl": "http:\/\/www.bayer.com\/doloribus-maiores-aut-rerum-vel.html",
        "displayUrl": "http:\/\/welch.com\/officia-numquam-nihil-et-occaecati-voluptates-autem.html"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}

6.8.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJhTkxaVlB2Z2NpQ0FKd2xpIiwic3ViIjoiMzIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.O-HzDOZ6l96wuYRBC_U8jgTNUVnyGtCzqDIKQLyVqmE' \
    -d '{
    "name": "Native creative #3",
    "creativeType": "native",
    "frequencyType": "user",
    "frequencyCap": 1,
    "frequencyPeriod": 1,
    "frequency": 1,
    "bidPrice": 0.5,
    "folderId": null,
    "native": {
        "smallImageId": 18,
        "largeImageId": 18,
        "assetDataDesc": "Velit officiis.",
        "assetTitle": "Non ullam.",
        "assetDataSponsored": "Vitae quis neque a.",
        "assetCtaText": "A labore.",
        "clickUrl": "http:\/\/www.bayer.com\/doloribus-maiores-aut-rerum-vel.html",
        "displayUrl": "http:\/\/welch.com\/officia-numquam-nihil-et-occaecati-voluptates-autem.html"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}'

6.8.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.media.id

integer

Media Id

data.media.userId

string

User Id

data.media.mediaType

string

Media type (html, image, video)

data.media.originName

string

Uploaded file original name

data.media.name

string

Uploaded file name

data.media.extension

string

Uploaded file extention

data.media.url

string

Uploaded file URL

data.media.width

integer

Uploaded file image width

data.media.height

integer

Uploaded file image height

data.media.weight

integer

Uploaded file size

data.media.modifiedUrl

any

data.relation.native.smallImageId

integer

Logo media id

data.relation.native.largeImageId

integer

Image media id

data.relation.native.smallImage.id

integer

Logo media id

data.relation.native.smallImage.folderId

string

Folder id

data.relation.native.smallImage.userId

integer

User id

data.relation.native.smallImage.width

string

width

data.relation.native.smallImage.height

string

height

data.relation.native.smallImage.name

string

name

data.relation.native.smallImage.url

string

url

data.relation.native.smallImage.href

string

href

data.relation.native.smallImage.originName

string

originName

data.relation.native.smallImage.path

string

path

data.relation.native.smallImage.extension

string

extension

data.relation.native.smallImage.mediaType

string

mediaType

data.relation.native.smallImage.createdAt

string

createdAt

data.relation.native.smallImage.updatedAt

string

updatedAt

data.relation.native.smallImage.deletedAt

string

updatedAt

data.relation.native.smallImage.weight

string

weight

data.relation.native.largeImage.id

integer

Image media id

data.relation.native.largeImage.folderId

string

Folder id

data.relation.native.largeImage.userId

integer

User id

data.relation.native.largeImage.width

string

width

data.relation.native.largeImage.height

string

height

data.relation.native.largeImage.name

string

name

data.relation.native.largeImage.url

string

url

data.relation.native.largeImage.href

string

href

data.relation.native.largeImage.originName

string

originName

data.relation.native.largeImage.path

string

path

data.relation.native.largeImage.extension

string

extension

data.relation.native.largeImage.mediaType

string

mediaType

data.relation.native.largeImage.createdAt

string

createdAt

data.relation.native.largeImage.updatedAt

string

updatedAt

data.relation.native.largeImage.deletedAt

string

updatedAt

data.relation.native.largeImage.weight

string

weight

data.relation.native.assetDataDesc

string

Ad text

data.relation.native.assetTitle

string

Ad title

data.relation.native.assetDataSponsored

string

Brand name

data.relation.native.assetCtaText

string

CTA button text

data.relation.native.clickUrl

string

Click URL

data.relation.native.displayUrl

string

Display URL

data.relation.native.impTracker

string

Impression tracker

data.sizes

string

size

6.8.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Creative created.",
    "data": {
        "id": 17,
        "userId": 32,
        "isActive": null,
        "approved": null,
        "creativeType": "native",
        "name": "Native creative #3",
        "frequencyType": "user",
        "frequency": 1,
        "frequencyCap": 1,
        "frequencyPeriod": 1,
        "bidPrice": 0.5,
        "autoresize": null,
        "adaptiveCpm": null,
        "size": "252 x 237",
        "weight": "0.00 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:38",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "native": {
                "smallImageId": 18,
                "largeImageId": 18,
                "smallImage": {
                    "id": 18,
                    "folderId": null,
                    "userId": 32,
                    "width": 252,
                    "height": 237,
                    "name": "32_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "url": "https:\/\/shanahan.com\/quidem-doloribus-voluptatem-dolores.html32_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "href": null,
                    "originName": "image.jpg",
                    "path": null,
                    "extension": "jpg",
                    "mediaType": "image",
                    "createdAt": "2025-03-26T09:53:38.000000Z",
                    "updatedAt": "2025-03-26T09:53:38.000000Z",
                    "deletedAt": null,
                    "weight": 450511
                },
                "largeImage": {
                    "id": 18,
                    "folderId": null,
                    "userId": 32,
                    "width": 252,
                    "height": 237,
                    "name": "32_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "url": "https:\/\/shanahan.com\/quidem-doloribus-voluptatem-dolores.html32_f02e3793889205f8f6cf53decfef52e1.jpg",
                    "href": null,
                    "originName": "image.jpg",
                    "path": null,
                    "extension": "jpg",
                    "mediaType": "image",
                    "createdAt": "2025-03-26T09:53:38.000000Z",
                    "updatedAt": "2025-03-26T09:53:38.000000Z",
                    "deletedAt": null,
                    "weight": 450511
                },
                "assetDataDesc": "Velit officiis.",
                "assetTitle": "Non ullam.",
                "assetDataSponsored": "Vitae quis neque a.",
                "assetCtaText": "A labore.",
                "clickUrl": "https:\/\/www.bayer.com\/doloribus-maiores-aut-rerum-vel.html",
                "displayUrl": "http:\/\/welch.com\/officia-numquam-nihil-et-occaecati-voluptates-autem.html",
                "impTracker": null
            }
        },
        "sizes": []
    }
}

6.9. Create a Custom Video Creative with Third-party tag

A `POST` request will create new creative.

6.9.1. Request Body

Path Type Description Required

name

string

Creative name

+

creativeType

string

Creative type: banner, native, video, audio

+

frequency

boolean

Frequency on/off.

bidPrice

float

CPM

+

video.sizes

string

Player size

+

video.mimeType

array

MIME types

+

video.admBody

string

Third-party tag

+

subCategories.IAB1

array

SubCategories (required if categories is empty)

+

categories.IAB1

array

Categories (required if subCategories is empty)

+

6.9.2. HTTP Request

URL

POST api/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJxcEE3RGQ4U09sVkZyTGdJIiwic3ViIjoiMzMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ry5YvhcUz5rX5FYN28LqwtW7GcoTj22jyum6ItzyJz4
DATA
{
    "name": "Video creative #3",
    "creativeType": "video",
    "frequency": 0,
    "bidPrice": 100,
    "video": {
        "sizes": "small",
        "mimeType": [
            "video\/mp4"
        ],
        "admBody": "<iframe src=\"url.to.script\"><\/iframe>"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}

6.9.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJxcEE3RGQ4U09sVkZyTGdJIiwic3ViIjoiMzMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ry5YvhcUz5rX5FYN28LqwtW7GcoTj22jyum6ItzyJz4' \
    -d '{
    "name": "Video creative #3",
    "creativeType": "video",
    "frequency": 0,
    "bidPrice": 100,
    "video": {
        "sizes": "small",
        "mimeType": [
            "video\/mp4"
        ],
        "admBody": "<iframe src=\"url.to.script\"><\/iframe>"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}'

6.9.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.relation.video.sizes

string

Player size

data.relation.video.admBody

string

Third-party tag

data.relation.video.mimeType

array

MIME types

data.relation.video.width

integer

Video width

data.relation.video.height

integer

Video height

data.relation.video.duration

integer

Video duration

data.relation.video.clickUrl

string

Click URL

data.relation.video.partyTagFormat

integer

3 party tag format (0-NO VPAID, 1-VPAID 1, 2-VPAID 2, 3-ALL VPAID)

data.relation.video.autoStoreEndCard

boolean

autoStoreEndCard

data.relation.video.autoStoreEndCardOption

string

autoStoreEndCardOption

data.sizes

string

size

6.9.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Creative created.",
    "data": {
        "id": 18,
        "userId": 33,
        "isActive": null,
        "approved": null,
        "creativeType": "video",
        "name": "Video creative #3",
        "frequencyType": null,
        "frequency": 0,
        "frequencyCap": null,
        "frequencyPeriod": null,
        "bidPrice": 100,
        "autoresize": null,
        "adaptiveCpm": null,
        "size": "0 x 0",
        "weight": "0.00 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:38",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "video": {
                "sizes": "small",
                "admBody": "<iframe src=\"url.to.script\"><\/iframe>",
                "mimeType": [
                    "video\/mp4"
                ],
                "width": 0,
                "height": 0,
                "duration": 0,
                "clickUrl": "",
                "partyTagFormat": null,
                "autoStoreEndCard": null,
                "autoStoreEndCardOption": null
            }
        },
        "sizes": []
    }
}

6.10. Create a Custom Video Creative with Media image

A `POST` request will create new creative.

6.10.1. Request Body

Path Type Description Required

name

string

Creative name

+

creativeType

string

Creative type: banner, native, video, audio

+

frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

frequency

boolean

Frequency on/off.

mediaId

array

Media video Id

+

bidPrice

float

CPM

+

video.clickUrl

string

Click URL

+

subCategories.IAB1

array

SubCategories (required if categories is empty)

+

categories.IAB1

array

Categories (required if subCategories is empty)

+

6.10.2. HTTP Request

URL

POST api/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJwNkt0RGkyN1FVQkdqREFRIiwic3ViIjoiMzQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ZxfD2TWyAJ_aBdozvlKqDYfe2omz2PwyY85LOf4w5hc
DATA
{
    "name": "Video creative #4",
    "creativeType": "video",
    "frequencyType": "user",
    "frequencyCap": 1,
    "frequencyPeriod": 1,
    "frequency": 1,
    "mediaId": 19,
    "bidPrice": 100,
    "video": {
        "clickUrl": "http:\/\/stroman.com\/omnis-sunt-sed-ducimus-ipsum-provident.html"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}

6.10.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTgsImV4cCI6MTc0Mjk4NjQxOCwibmJmIjoxNzQyOTgyODE4LCJqdGkiOiJwNkt0RGkyN1FVQkdqREFRIiwic3ViIjoiMzQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ZxfD2TWyAJ_aBdozvlKqDYfe2omz2PwyY85LOf4w5hc' \
    -d '{
    "name": "Video creative #4",
    "creativeType": "video",
    "frequencyType": "user",
    "frequencyCap": 1,
    "frequencyPeriod": 1,
    "frequency": 1,
    "mediaId": 19,
    "bidPrice": 100,
    "video": {
        "clickUrl": "http:\/\/stroman.com\/omnis-sunt-sed-ducimus-ipsum-provident.html"
    },
    "subCategories": {
        "IAB1": [
            "IAB1-1"
        ]
    },
    "categories": {
        "IAB1": true
    }
}'

6.10.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.media.id

integer

Media Id

data.media.userId

string

User Id

data.media.mediaType

string

Media type (html, image, video)

data.media.originName

string

Uploaded file original name

data.media.name

string

Uploaded file name

data.media.extension

string

Uploaded file extention

data.media.url

string

Uploaded file URL

data.media.width

integer

Uploaded file image width

data.media.height

integer

Uploaded file image height

data.media.weight

integer

Uploaded file size

data.media.modifiedUrl

any

data.relation.video.sizes

string

Player size

data.relation.video.admBody

string

Third-party tag

data.relation.video.mimeType

array

MIME types

data.relation.video.width

integer

Video width

data.relation.video.height

integer

Video height

data.relation.video.duration

integer

Video duration

data.relation.video.clickUrl

string

Click URL

data.relation.video.partyTagFormat

integer

3 party tag format (0-NO VPAID, 1-VPAID 1, 2-VPAID 2, 3-ALL VPAID)

data.relation.video.autoStoreEndCard

boolean

autoStoreEndCard

data.relation.video.autoStoreEndCardOption

string

autoStoreEndCardOption

data.sizes

string

size

6.10.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Creative created.",
    "data": {
        "id": 19,
        "userId": 34,
        "isActive": null,
        "approved": null,
        "creativeType": "video",
        "name": "Video creative #4",
        "frequencyType": "user",
        "frequency": 1,
        "frequencyCap": 1,
        "frequencyPeriod": 1,
        "bidPrice": 100,
        "autoresize": null,
        "adaptiveCpm": null,
        "size": "140 x 382",
        "weight": "0.31 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:38",
        "updatedAt": "2025-03-26 09:53:39",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "video": {
                "sizes": "small",
                "admBody": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"2.0\">\n<Ad id=\"[HASH]\">\n    <InLine>\n        <AdSystem>DSP<\/AdSystem>\n        <AdTitle>Smartyads<\/AdTitle>\n        <Description>RTB<\/Description>\n        <Creatives>\n            <Creative AdID=\"19\">\n                <Linear>\n                    <Duration>00:00:05<\/Duration>\n                    <VideoClicks>\n                        <ClickThrough><![CDATA[https:\/\/stroman.com\/omnis-sunt-sed-ducimus-ipsum-provident.html]]><\/ClickThrough>\n                    <\/VideoClicks>\n                    <MediaFiles>\n                        <MediaFile delivery=\"\" type=\"video\/mp4\" width=\"140\" height=\"382\"><![CDATA[http:\/\/www.gusikowski.com\/hic-consequatur-sit-est-consequatur34_f02e3793889205f8f6cf53decfef52e1.mp4]]><\/MediaFile>\n                    <\/MediaFiles>\n                <\/Linear>\n            <\/Creative>\n        <\/Creatives>\n    <\/InLine>\n<\/Ad>\n<\/VAST>",
                "mimeType": [
                    "video\/mp4"
                ],
                "width": 140,
                "height": 382,
                "duration": 5,
                "clickUrl": "https:\/\/stroman.com\/omnis-sunt-sed-ducimus-ipsum-provident.html",
                "partyTagFormat": null,
                "autoStoreEndCard": null,
                "autoStoreEndCardOption": null
            }
        },
        "sizes": []
    }
}

6.11. Update a Custom Creative

A `PATCH` request will update creative.

6.11.1. Request Body

Path Type Description Required

isActive

boolean

Creative status

6.11.2. HTTP Request

URL

PUT api/creatives/20 HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJLT2xnQ3JjYXJlbGdyeHBGIiwic3ViIjoiMzUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.9qIZsAaeXkXmtjRbFYUzWN1tvrZuz-SKNF1oCZI82ok
DATA
{
    "isActive": true
}

6.11.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives/20' -i -X PUT \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJLT2xnQ3JjYXJlbGdyeHBGIiwic3ViIjoiMzUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.9qIZsAaeXkXmtjRbFYUzWN1tvrZuz-SKNF1oCZI82ok' \
    -d '{
    "isActive": true
}'

6.11.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

Creative Id

data.userId

integer

User Id

data.isActive

boolean

Creative status

data.approved

string

Creative approval status (approved, pending, disapproved)

data.creativeType

string

Creative type: banner, native, video, audio

data.name

string

Creative name

data.frequencyType

string

Frequency Type (user, ip).Required if frequency is on.

data.frequency

boolean

Frequency on/off.

data.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period".Required if frequency is on.

data.frequencyPeriod

integer

Frequency Period (min-1,max-3). Required if frequency is on.

data.bidPrice

float

CPM

data.autoresize

boolean

autoresize

data.adaptiveCpm

bool

adaptiveCpm

data.size

string

Image width and height

data.weight

string

File size

data.folderId

string

Folder Id

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.pendingAt

datetime

Date of pending start

data.deletedAt

datetime

Date of deletion

data.relation.banner.apiFramework

integer

Rich Media: 0-NO MRAID, 3-MRAID1, 5-MRAID2, 6-MRAID3, 10-ALL MRAID

data.relation.banner.admBody

string

Third-party tag

data.relation.banner.bannerType

String

Banner type (banner,inBannerVideo)

data.relation.banner.clickUrl

string

Click URL

data.relation.banner.width

integer

Banner width

data.relation.banner.height

integer

Banner height

data.sizes

string

size

6.11.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Creative updated.",
    "data": {
        "id": 20,
        "userId": 35,
        "isActive": true,
        "approved": "pending",
        "creativeType": "banner",
        "name": "consequatur eius",
        "frequencyType": "ip",
        "frequency": 0,
        "frequencyCap": 1,
        "frequencyPeriod": 1,
        "bidPrice": "10.95",
        "autoresize": 0,
        "adaptiveCpm": false,
        "size": " x ",
        "weight": "0.00 MB",
        "folderId": null,
        "createdAt": "2025-03-26 09:53:39",
        "updatedAt": "2025-03-26 09:53:39",
        "pendingAt": null,
        "deletedAt": null,
        "relation": {
            "banner": {
                "apiFramework": null,
                "admBody": null,
                "bannerType": null,
                "clickUrl": null,
                "width": null,
                "height": null
            }
        },
        "sizes": []
    }
}

6.12. Delete a Custom Creative

A `DELETE` request will delete creative.

6.12.1. HTTP Request

URL

DELETE api/creatives/21 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJKWHduTXpLS01GMGloRlpEIiwic3ViIjoiMzYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ZDSC757_BEXzBlRuz2XdjgU6Zt8gsPE2_7UFaKPUbAw
Content-type: application/x-www-form-urlencoded
DATA
{}

6.12.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/creatives/21' -i -X DELETE \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJKWHduTXpLS01GMGloRlpEIiwic3ViIjoiMzYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.ZDSC757_BEXzBlRuz2XdjgU6Zt8gsPE2_7UFaKPUbAw' \
                -H 'Content-type: application/x-www-form-urlencoded' \
    -d '{}'

6.12.3. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{}

7. Assign Creatives to Campaigns

7.1. Get list of Creatives assigned to Campaign

A `GET` request with Campaign Id in url will get list of Creatives assigned to Campaign

7.1.1. HTTP Request

URL

GET api/campaigns/12/creatives HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJHY3RWNXVCZUhzaWFNM1FoIiwic3ViIjoiMTciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.GLyFI6udSn6qU9Zh7zY21OkcsY50gpzWGLH8ydj2QzY
DATA
{}

7.1.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/12/creatives' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJHY3RWNXVCZUhzaWFNM1FoIiwic3ViIjoiMTciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.GLyFI6udSn6qU9Zh7zY21OkcsY50gpzWGLH8ydj2QzY' \
    -d '{}'

7.1.3. Response Body

Path Type Description

data.*.id

integer

Creative Id

data.*.userId

integer

User Id

data.*.isActive

boolean

Creative status

data.*.approved

string

Creative approval status (approved, pending, disapproved)

data.*.creativeType

string

Creative type: banner, native, video, audio

data.*.name

string

Creative name

data.*.frequencyType

string

Identify the user to limit the number of the ad shows for the specific user (user, ip). Required if frequency is on.

data.*.frequency

string

Frequency on/off

data.*.frequencyCap

integer

Show ads no more than "Frequency Cap" times in "Frequency Period". Required if frequency is on.

data.*.frequencyPeriod

integer

Frequency period in days (min-1,max-3). Required if frequency is on.

data.*.bidPrice

float

CPM

data.*.autoresize

boolean

autoresize

data.*.adaptiveCpm

bool

adaptiveCpm

data.*.size

string

Image width and height

data.*.weight

string

File size

data.*.folderId

string

Folder Id

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

data.*.pendingAt

datetime

Date of pending start

data.*.deletedAt

datetime

Date of deletion

data.*.status

string

Status

meta.pagination.total

integer

Pagination: total items count

meta.pagination.count

integer

Pagination: page items count

meta.pagination.per_page

integer

Pagination: items per page

meta.pagination.current_page

integer

Pagination: current page number

meta.pagination.total_pages

integer

Pagination: total pages count

meta.pagination.links

object

Pagination links

7.1.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": [
        {
            "id": 1,
            "userId": 17,
            "isActive": 0,
            "approved": "pending",
            "creativeType": "banner",
            "name": "Test Creative #1",
            "frequencyType": "user",
            "frequency": 0,
            "frequencyCap": 7,
            "frequencyPeriod": 1,
            "bidPrice": "10.86",
            "autoresize": 0,
            "adaptiveCpm": false,
            "size": "373 x 326",
            "weight": "0.37 MB",
            "folderId": null,
            "createdAt": "2025-03-26 09:53:36",
            "updatedAt": "2025-03-26 09:53:36",
            "pendingAt": null,
            "deletedAt": null,
            "media": {
                "id": 1,
                "userId": 17,
                "mediaType": "image",
                "originName": "image.jpg",
                "name": "17_68e66b2237a28ad080b430d2c1289c4d.jpg",
                "extension": "jpg",
                "url": "https:\/\/bailey.com\/magnam-aut-rerum-quia-doloribus-facilis.html17_68e66b2237a28ad080b430d2c1289c4d.jpg",
                "width": 338,
                "height": 340,
                "weight": 385792
            },
            "relation": {
                "banner": {
                    "apiFramework": 0,
                    "admBody": "<a target=\"_blank\" href=\"https:\/\/www.wyman.com\/quo-error-hic-repellendus-sunt-voluptas\" ><img src=\"http:\/\/schamberger.com\/\/10.jpg\"\/><\/a>",
                    "bannerType": "banner",
                    "clickUrl": "http:\/\/steuber.com\/officiis-consequatur-consequatur-quibusdam-quia-natus-maiores-eum",
                    "width": 373,
                    "height": 326,
                    "childrenCreative": null,
                    "statusChildrenCreative": [],
                    "main": 1
                }
            },
            "status": ""
        }
    ],
    "meta": {
        "pagination": {
            "total": 1,
            "count": 1,
            "per_page": 1000,
            "current_page": 1,
            "total_pages": 1,
            "links": []
        }
    }
}

7.2. Replace Creatives assigned to Campaign

A `POST` request with Campaign Id in url will replace Creatives assigned to Campaign

7.2.1. Request Body

Path Type Description Required

ids

array

array of Creative ids

+

7.2.2. HTTP Request

URL

POST api/campaigns/13/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJZVFdYZURBU2JWcTJBbTY0Iiwic3ViIjoiMTgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.UUnsseTxG_56mMJV4RpCmIhe9qF1PQLw4JsJiZYJEq8
DATA
{
    "ids": [
        2,
        3
    ]
}

7.2.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/13/creatives' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJZVFdYZURBU2JWcTJBbTY0Iiwic3ViIjoiMTgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.UUnsseTxG_56mMJV4RpCmIhe9qF1PQLw4JsJiZYJEq8' \
    -d '{
    "ids": [
        2,
        3
    ]
}'

7.2.4. Response Body

Path Type Description

message

string

Result message

7.2.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Replaced."
}

7.3. Append Creatives assigned to Campaign

A `PATCH` request with Campaign Id in url will append Creatives assigned to Campaign

7.3.1. Request Body

Path Type Description Required

ids

array

array of Creative ids

+

7.3.2. HTTP Request

URL

PATCH api/campaigns/14/creatives HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJvTENYYlRlQUZ0OHkzRkNsIiwic3ViIjoiMTkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.0czkR5cG5F62Wn3xzk8dZQ2u3rmrpB5r2NgZSHwa8nU
DATA
{
    "ids": [
        5
    ]
}

7.3.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/14/creatives' -i -X PATCH \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJvTENYYlRlQUZ0OHkzRkNsIiwic3ViIjoiMTkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.0czkR5cG5F62Wn3xzk8dZQ2u3rmrpB5r2NgZSHwa8nU' \
    -d '{
    "ids": [
        5
    ]
}'

7.3.4. Response Body

Path Type Description

message

string

Result message

7.3.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Appended."
}

7.4. Remove Creatives assigned to Campaign

A `DELETE` request with Campaign Id in url will remove Creatives assigned to Campaign

7.4.1. Request Body

Path Type Description Required

ids

array

array of Creative ids

+

7.4.2. HTTP Request

URL

DELETE api/campaigns/15/creatives HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJac3l3SHRVYUxNdERiZ2Z6Iiwic3ViIjoiMjAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.m0Cq-brpa6E5vg8TIO1TeSN1zlvbcrvagHSKasYHXyo
Content-type: application/x-www-form-urlencoded
DATA
{
    "ids": [
        7
    ]
}

7.4.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/15/creatives' -i -X DELETE \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJac3l3SHRVYUxNdERiZ2Z6Iiwic3ViIjoiMjAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.m0Cq-brpa6E5vg8TIO1TeSN1zlvbcrvagHSKasYHXyo' \
                -H 'Content-type: application/x-www-form-urlencoded' \
    -d '{
    "ids": [
        7
    ]
}'

7.4.4. Response Body

Path Type Description

message

string

Result message

deleted

boolean

Deleting result

7.4.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Deleted.",
    "deleted": true
}

8. Filterlists

8.1. Filter lists

A `GET` request will return a filter lists

8.1.1. HTTP Request

URL

GET api/filterlist HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJBSHA0N0k2cUl2RTRzY3E2Iiwic3ViIjoiMzciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.KBun_OeFXf9SCiU-I57sER04VGhhG0p5x5X0N7-acWA
DATA
{}

8.1.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/filterlist' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJBSHA0N0k2cUl2RTRzY3E2Iiwic3ViIjoiMzciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.KBun_OeFXf9SCiU-I57sER04VGhhG0p5x5X0N7-acWA' \
    -d '{}'

8.1.3. Response Body

Path Type Description

data.*.id

integer

List Id

data.*.isActive

bool

on/off

data.*.userId

integer

User Id

data.*.title

string

List title

data.*.type

string

Filter list type: listDomains, listApps, listBundles, listDeviceIfas, listPublishers, listIpAdresses, listSiteAndAppIds, listUrls, listTags

data.*.isInclude

boolean

White/Black list

data.*.count

integer

Object count

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

meta.pagination.total

integer

Pagination: total items count

meta.pagination.count

integer

Pagination: page items count

meta.pagination.per_page

integer

Pagination: items per page

meta.pagination.current_page

integer

Pagination: current page number

meta.pagination.total_pages

integer

Pagination: total pages count

meta.pagination.links

array

Pagination: array links

8.1.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": [
        {
            "id": 10,
            "isActive": 0,
            "userId": 37,
            "title": "Test Filter list #1",
            "type": "domain",
            "isInclude": "White",
            "count": 1,
            "createdAt": "2025-03-26",
            "updatedAt": "2025-03-26"
        },
        {
            "id": 11,
            "isActive": 0,
            "userId": 37,
            "title": "Test Filter list #2",
            "type": "ipAdresses",
            "isInclude": "White",
            "count": 2,
            "createdAt": "2025-03-26",
            "updatedAt": "2025-03-26"
        },
        {
            "id": 12,
            "isActive": 0,
            "userId": 37,
            "title": "Test Filter list #3",
            "type": "urls",
            "isInclude": "White",
            "count": 3,
            "createdAt": "2025-03-26",
            "updatedAt": "2025-03-26"
        }
    ],
    "meta": {
        "pagination": {
            "total": 3,
            "count": 3,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 1,
            "links": []
        }
    }
}

8.2. Get filter lists by ID

A `GET` request will return a filter list  by ID

8.2.1. HTTP Request

URL

GET api/filterlist/13 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJvUVl2Z1lRWEVzdGpkY1NvIiwic3ViIjoiMzgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.UJgqDj5hRV0xO-FiS_AFjVjS1F4HHlITL81T5kp8R4g
DATA
{}

8.2.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/filterlist/13' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJvUVl2Z1lRWEVzdGpkY1NvIiwic3ViIjoiMzgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.UJgqDj5hRV0xO-FiS_AFjVjS1F4HHlITL81T5kp8R4g' \
    -d '{}'

8.2.3. Response Body

Path Type Description

data.id

integer

List Id

data.userId

integer

User Id

data.isActive

bool

on/off

data.title

string

List title

data.type

string

Filter list type: listDomains, listApps, listBundles, listDeviceIfas, listPublishers, listIpAdresses, listSiteAndAppIds, listUrls, listTags

data.isInclude

boolean

White/Black list

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.items

array

items

data.listCount

integer

listCount

8.2.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 13,
        "userId": 38,
        "isActive": 0,
        "title": "Test Filter list #4",
        "type": "domain",
        "isInclude": true,
        "createdAt": "2025-03-26",
        "updatedAt": "2025-03-26",
        "items": [
            "glover.net",
            "hahn.com",
            "lakin.com",
            "mosciski.com",
            "murazik.com"
        ],
        "listCount": 5
    }
}

8.3. Create a filter lists

A `POST` request will set new filter list

8.3.1. Request Body

Path Type Description Required

title

string

List title

+

type

string

Filter list type: domain, apps, bundles, deviceIfas, publishers, ipAdresses, siteAndAppsIds, urls, tagIds

+

isInclude

bool

white/black

+

items

array

List array items (can be empty if there fileName)

fileName

string

null

File name from upload file - Store filter list

8.3.2. HTTP Request

URL

POST api/filterlist HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJKSnNyUE5SRnJGUHgxYlp1Iiwic3ViIjoiMzkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.xih3F3JyWSw-0Cg_Vf0QwZwgAFNR9vOjiYnH-2zEzKQ
DATA
{
    "title": "Test Filter list #5",
    "type": "ipAdresses",
    "isInclude": true,
    "items": [
        "224.107.177.4",
        "195.59.210.3",
        "40.245.151.151",
        "254.196.70.9",
        "194.190.55.156"
    ],
    "fileName": null
}

8.3.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/filterlist' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJKSnNyUE5SRnJGUHgxYlp1Iiwic3ViIjoiMzkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.xih3F3JyWSw-0Cg_Vf0QwZwgAFNR9vOjiYnH-2zEzKQ' \
    -d '{
    "title": "Test Filter list #5",
    "type": "ipAdresses",
    "isInclude": true,
    "items": [
        "224.107.177.4",
        "195.59.210.3",
        "40.245.151.151",
        "254.196.70.9",
        "194.190.55.156"
    ],
    "fileName": null
}'

8.3.4. Response Body

Path Type Description

message

string

message

data.id

integer

List Id

data.userId

integer

User Id

data.isActive

bool

on/off

data.title

string

List title

data.type

string

Filter list type: listDomains, listApps, listBundles, listDeviceIfas, listPublishers, listIpAdresses, listSiteAndAppIds, listUrls, listTags

data.isInclude

boolean

White (1)/Black list(0)

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.items

array

List array items (can be empty if there fileName)

data.listCount

integer

list count

8.3.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "FilterList created.",
    "data": {
        "id": 14,
        "userId": 39,
        "isActive": null,
        "title": "Test Filter list #5",
        "type": "ipAdresses",
        "isInclude": true,
        "createdAt": "2025-03-26",
        "updatedAt": "2025-03-26",
        "items": [],
        "listCount": 0
    }
}

8.4. Filter lists update

A `PATCH` request will update filter lists

8.4.1. Request Body

Path Type Description Required

title

string

List title

isInclude

bool

white/black

items

array

List array items (can be empty if there fileName)

fileName

string

null

File name from upload file - Store filter list

8.4.2. HTTP Request

URL

PUT api/filterlist/15 HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJBZjVTenhlRWU4czdnZ2VlIiwic3ViIjoiNDAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.gFyUsR1uNHsrA0djmyLL0zTaaC-nM0Cuz7fPPIBTAd8
DATA
{
    "title": "Test FilterList #7",
    "isInclude": true,
    "items": [
        "http:\/\/www.mcglynn.info\/unde-voluptatem-est-natus-nobis-odit-repellat",
        "http:\/\/graham.com\/quod-vero-cumque-neque-voluptatem-quo-sunt-quia.html",
        "http:\/\/www.kuhic.org\/"
    ],
    "fileName": null
}

8.4.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/filterlist/15' -i -X PUT \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJBZjVTenhlRWU4czdnZ2VlIiwic3ViIjoiNDAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.gFyUsR1uNHsrA0djmyLL0zTaaC-nM0Cuz7fPPIBTAd8' \
    -d '{
    "title": "Test FilterList #7",
    "isInclude": true,
    "items": [
        "http:\/\/www.mcglynn.info\/unde-voluptatem-est-natus-nobis-odit-repellat",
        "http:\/\/graham.com\/quod-vero-cumque-neque-voluptatem-quo-sunt-quia.html",
        "http:\/\/www.kuhic.org\/"
    ],
    "fileName": null
}'

8.4.4. Response Body

Path Type Description

message

string

Result message

data.id

integer

List Id

data.userId

integer

User Id

data.isActive

bool

on/off

data.title

string

List title

data.type

string

Filter list type: domain, apps, bundles, deviceIfas, publishers, ipAdresses, siteAndAppsIds, urls, tagIds

data.isInclude

boolean

white/black

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

data.items

array

List items

data.listCount

integer

listCount

8.4.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "FilterList updated.",
    "data": {
        "id": 15,
        "userId": 40,
        "isActive": 0,
        "title": "Test FilterList #7",
        "type": "urls",
        "isInclude": true,
        "createdAt": "2025-03-26",
        "updatedAt": "2025-03-26",
        "items": [
            "http:\/\/www.franecki.net\/cupiditate-ducimus-alias-excepturi-consectetur-cupiditate-enim-corrupti",
            "https:\/\/www.auer.com\/adipisci-voluptas-aliquam-quisquam-ut-repellendus-nihil"
        ],
        "listCount": 2
    }
}

8.5. Filter lists delete

A `DELETE` request will delete a filter lists

8.5.1. HTTP Request

URL

DELETE api/filterlist/16 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJhUWFlaWtpMnBoNGVLNG5yIiwic3ViIjoiNDEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.5cRiZ4Cs9LpM4x82yd4jRsNmOzx0MJU1d_Hkp9ASQ_U
Content-type: application/x-www-form-urlencoded
DATA
{}

8.5.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/filterlist/16' -i -X DELETE \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTksImV4cCI6MTc0Mjk4NjQxOSwibmJmIjoxNzQyOTgyODE5LCJqdGkiOiJhUWFlaWtpMnBoNGVLNG5yIiwic3ViIjoiNDEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.5cRiZ4Cs9LpM4x82yd4jRsNmOzx0MJU1d_Hkp9ASQ_U' \
                -H 'Content-type: application/x-www-form-urlencoded' \
    -d '{}'

8.5.3. Response Body

Path Type Description

message

string

Result message

deleted

boolean

is deleted

8.5.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "FilterList deleted.",
    "deleted": true
}

9. Assign Filterlists to Campaigns

9.1. Get list of Filter Lists assigned to Campaign

A `GET` request with Campaign Id in url will get list of Filter Lists assigned to Campaign

9.1.1. HTTP Request

URL

GET api/campaigns/16/filterlists HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJBQlZyNExvVkhNTHFPM3FFIiwic3ViIjoiMjEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0._mxlAZlbMy76rzKq1hu7rvN9eOQTWiy6lVdRzGALicw
DATA
{}

9.1.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/16/filterlists' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJBQlZyNExvVkhNTHFPM3FFIiwic3ViIjoiMjEiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0._mxlAZlbMy76rzKq1hu7rvN9eOQTWiy6lVdRzGALicw' \
    -d '{}'

9.1.3. Response Body

Path Type Description

data.*.isInclude

boolean

List is Include

data.*.filterList.id

integer

List Id

data.*.filterList.isActive

bool

on/off

data.*.filterList.userId

integer

User Id

data.*.filterList.title

string

List title

data.*.filterList.type

string

Filter list type: listDomains, listApps, listBundles, listDeviceIfas, listPublishers, listIpAdresses, listSiteAndAppIds, listUrls, listTags

data.*.filterList.isInclude

boolean

White/Black list

data.*.filterList.count

integer

Object count

data.*.filterList.createdAt

datetime

Date of creation

data.*.filterList.updatedAt

datetime

Date of last modification

meta.pagination.total

integer

Pagination: total items count

meta.pagination.count

integer

Pagination: page items count

meta.pagination.per_page

integer

Pagination: items per page

meta.pagination.current_page

integer

Pagination: current page number

meta.pagination.total_pages

integer

Pagination: total pages count

meta.pagination.links

array

Pagination: array links

9.1.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": [
        {
            "isInclude": true,
            "filterList": {
                "id": 1,
                "isActive": 0,
                "userId": 21,
                "title": "Test Filter list #1",
                "type": "domain",
                "isInclude": "White",
                "count": 1,
                "createdAt": "2025-03-26",
                "updatedAt": "2025-03-26"
            }
        },
        {
            "isInclude": true,
            "filterList": {
                "id": 2,
                "isActive": 0,
                "userId": 21,
                "title": "Test Filter list #2",
                "type": "ipAdresses",
                "isInclude": "White",
                "count": 1,
                "createdAt": "2025-03-26",
                "updatedAt": "2025-03-26"
            }
        },
        {
            "isInclude": true,
            "filterList": {
                "id": 3,
                "isActive": 0,
                "userId": 21,
                "title": "Test Filter list #3",
                "type": "urls",
                "isInclude": "White",
                "count": 1,
                "createdAt": "2025-03-26",
                "updatedAt": "2025-03-26"
            }
        }
    ],
    "meta": {
        "pagination": {
            "total": 3,
            "count": 3,
            "per_page": 1000,
            "current_page": 1,
            "total_pages": 1,
            "links": []
        }
    }
}

9.2. Replace Filter Lists assigned to Campaign

A `POST` request with Campaign Id in url will replace Filter Lists assigned to Campaign

9.2.1. Request Body

Path Type Description Required

items.*.id

integer

Filter list id

+

9.2.2. HTTP Request

URL

POST api/campaigns/17/filterlists HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiI5Y0IyaURjcG4xc1Fqc2dMIiwic3ViIjoiMjIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.MeLuPtweqKiXo8LsZjc1BciQ2x2_ggBBNjyCKwIKyjw
DATA
{
    "items": [
        {
            "id": 4
        },
        {
            "id": 5
        }
    ]
}

9.2.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/17/filterlists' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiI5Y0IyaURjcG4xc1Fqc2dMIiwic3ViIjoiMjIiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.MeLuPtweqKiXo8LsZjc1BciQ2x2_ggBBNjyCKwIKyjw' \
    -d '{
    "items": [
        {
            "id": 4
        },
        {
            "id": 5
        }
    ]
}'

9.2.4. Response Body

Path Type Description

message

string

Result message

9.2.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Replaced."
}

9.3. Append Filter Lists assigned to Campaign

A `PATCH` request with Campaign Id in url will append Filter Lists assigned to Campaign

9.3.1. Request Body

Path Type Description Required

items.*.id

integer

Filter list id

+

items.*.isInclude

boolean

Filter list type: include or exclude

+

9.3.2. HTTP Request

URL

PATCH api/campaigns/18/filterlists HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJVUUEwZmt6SnRMTEdFc2FaIiwic3ViIjoiMjMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.rM1EGq1GDdYyf5y4Sp5iP2sVtbn-srFZheLR7l_jsAo
DATA
{
    "items": [
        {
            "id": 7,
            "isInclude": true
        }
    ]
}

9.3.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/18/filterlists' -i -X PATCH \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJVUUEwZmt6SnRMTEdFc2FaIiwic3ViIjoiMjMiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.rM1EGq1GDdYyf5y4Sp5iP2sVtbn-srFZheLR7l_jsAo' \
    -d '{
    "items": [
        {
            "id": 7,
            "isInclude": true
        }
    ]
}'

9.3.4. Response Body

Path Type Description

message

string

Result message

9.3.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Appended."
}

9.4. Remove Filter Lists assigned to Campaign

A `DELETE` request with Campaign Id in url will remove Filter Lists assigned to Campaign

9.4.1. Request Body

Path Type Description Required

ids

array

List id to remove

+

9.4.2. HTTP Request

URL

DELETE api/campaigns/19/filterlists HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJGeXRuWkFGQTMwUkNNelNvIiwic3ViIjoiMjQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.RYFOucvn7K0rdcwJzLuOL2YQY2Zj_4IGBkOWdDXMR2I
Content-type: application/x-www-form-urlencoded
DATA
{
    "ids": [
        9
    ]
}

9.4.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaigns/19/filterlists' -i -X DELETE \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTcsImV4cCI6MTc0Mjk4NjQxNywibmJmIjoxNzQyOTgyODE3LCJqdGkiOiJGeXRuWkFGQTMwUkNNelNvIiwic3ViIjoiMjQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.RYFOucvn7K0rdcwJzLuOL2YQY2Zj_4IGBkOWdDXMR2I' \
                -H 'Content-type: application/x-www-form-urlencoded' \
    -d '{
    "ids": [
        9
    ]
}'

9.4.4. Response Body

Path Type Description

message

string

Result message

9.4.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "message": "Deleted."
}

10. Optimization Rule

10.1. Rule

A `GET` request will return a optimization rules

10.1.1. HTTP Request

URL

GET api/optimization-rule HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJydzc3dmJZRmUzWVpTVHU2Iiwic3ViIjoiNDYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.OgvA5EvS477bYExSQwK90mavxAfJckOC6mkMfIBomNI
DATA
{}

10.1.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/optimization-rule' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJydzc3dmJZRmUzWVpTVHU2Iiwic3ViIjoiNDYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.OgvA5EvS477bYExSQwK90mavxAfJckOC6mkMfIBomNI' \
    -d '{}'

10.1.3. Response Body

Path Type Description

data.*.id

integer

Id

data.*.userId

integer

User Id

data.*.ownerCampaignId

integer

Campaign id where it was created rule

data.*.name

string

Name

data.*.timeRange

string

type: last_day,last_3_days,last_week,last_month

data.*.then

string

type: whitelist_source,blacklist_source

data.*.targetFilterListId

integer

Filter list id

data.*.conditions

Array

Conditions

data.*.createdAt

datetime

Date of creation

data.*.updatedAt

datetime

Date of last modification

meta.pagination.total

integer

Pagination: total items count

meta.pagination.count

integer

Pagination: page items count

meta.pagination.per_page

integer

Pagination: items per page

meta.pagination.current_page

integer

Pagination: current page number

meta.pagination.total_pages

integer

Pagination: total pages count

meta.pagination.links

array

Pagination: array links

10.1.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": [
        {
            "id": 4,
            "userId": 46,
            "ownerCampaignId": 0,
            "name": "TEST Rule#1",
            "timeRange": "last_3_days",
            "then": "blacklist_source",
            "targetFilterListId": 1,
            "conditions": [],
            "createdAt": "2025-03-26T09:53:40.000000Z",
            "updatedAt": "2025-03-26T09:53:40.000000Z"
        }
    ],
    "meta": {
        "pagination": {
            "total": 1,
            "count": 1,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 1,
            "links": []
        }
    }
}

10.2. Get rule by ID

A `GET` request will return a optimization rule

10.2.1. HTTP Request

URL

GET api/optimization-rule/5 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiI2QVpTV0t2ZWk0V1JtVlM0Iiwic3ViIjoiNDciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.--9wJ2kNqD-NF2VcEsWpfZOovIsZXHixeKSgDIFfLmo
DATA
{}

10.2.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/optimization-rule/5' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiI2QVpTV0t2ZWk0V1JtVlM0Iiwic3ViIjoiNDciLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.--9wJ2kNqD-NF2VcEsWpfZOovIsZXHixeKSgDIFfLmo' \
    -d '{}'

10.2.3. Response Body

Path Type Description

data.id

integer

Id

data.userId

integer

User Id

data.ownerCampaignId

integer

Campaign id where it was created rule

data.name

string

Name

data.timeRange

string

type: last_day,last_3_days,last_week,last_month

data.then

string

type: whitelist_source,blacklist_source

data.targetFilterListId

integer

Filter list id

data.conditions

Array

Conditions

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

10.2.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 5,
        "userId": 47,
        "ownerCampaignId": 0,
        "name": "TEST Rule#1",
        "timeRange": "last_3_days",
        "then": "whitelist_source",
        "targetFilterListId": 1,
        "conditions": [],
        "createdAt": "2025-03-26T09:53:40.000000Z",
        "updatedAt": "2025-03-26T09:53:40.000000Z"
    }
}

10.3. Create a rule

A `POST` request will return a optimization rule

10.3.1. Request Body

Path Type Description Required

name

string

Name

+

timeRange

string

type: (last_day,last_3_days,last_week,last_month)

+

then

string

type: (whitelist_source,blacklist_source)

+

targetFilterListId

integer

Filter list id

+

conditions.*.condition

string

Condition type: (when,and,or) first condition must be - when

+

conditions.*.action

string

Actions type: (ctr,clicks,winrate,impressions,dspSpend)

+

conditions.*.comparison

string

Comparison type: (>,<,=)

+

conditions.*.value

string

Value

+

10.3.2. HTTP Request

URL

POST api/optimization-rule HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJSNGlvRkMzdUIxYU1kdEY0Iiwic3ViIjoiNDgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.cis5oydJ_SoQnylP7hXXH6DraLD5TC8aJDo04un2WGM
DATA
{
    "name": "Test",
    "timeRange": "last_day",
    "then": "blacklist_source",
    "targetFilterListId": 17,
    "conditions": [
        {
            "condition": "when",
            "action": "dspPrice",
            "comparison": ">",
            "value": "0.5"
        }
    ]
}

10.3.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/optimization-rule' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJSNGlvRkMzdUIxYU1kdEY0Iiwic3ViIjoiNDgiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.cis5oydJ_SoQnylP7hXXH6DraLD5TC8aJDo04un2WGM' \
    -d '{
    "name": "Test",
    "timeRange": "last_day",
    "then": "blacklist_source",
    "targetFilterListId": 17,
    "conditions": [
        {
            "condition": "when",
            "action": "dspPrice",
            "comparison": ">",
            "value": "0.5"
        }
    ]
}'

10.3.4. Response Body

Path Type Description

data.id

integer

Id

data.userId

integer

User Id

data.ownerCampaignId

integer

Campaign id where it was created rule

data.name

string

Name

data.timeRange

string

type: (last_day,last_3_days,last_week,last_month)

data.then

string

type: (whitelist_source,blacklist_source)

data.targetFilterListId

integer

Filter list id

data.conditions

Array

Conditions

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

10.3.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 6,
        "userId": 0,
        "ownerCampaignId": 0,
        "name": "Test",
        "timeRange": "last_day",
        "then": "blacklist_source",
        "targetFilterListId": 17,
        "conditions": [],
        "createdAt": "2025-03-26T09:53:40.000000Z",
        "updatedAt": "2025-03-26T09:53:40.000000Z"
    }
}

10.4. Rule update

A `PATCH` request will return a optimization rule

10.4.1. Request Body

Path Type Description Required

name

string

Name

+

timeRange

string

type: (last_day,last_3_days,last_week,last_month)

+

then

string

type: (whitelist_source,blacklist_source)

+

targetFilterListId

integer

Filter list id

+

conditions.*.condition

string

Condition type: (when,and,or) first condition must be - when

+

conditions.*.action

string

Actions type: (ctr,clicks,winrate,impressions,dspSpend)

+

conditions.*.comparison

string

Comparison type: (>,<,=)

+

conditions.*.value

string

Value

+

10.4.2. HTTP Request

URL

PUT api/optimization-rule/7 HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJ4U2V2MWNOYUtoYlJFMlIwIiwic3ViIjoiNDkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.Pe9KdNSnhVqzu7iX6JILYQZI4fNYhOwkwxiYq9OEdS8
DATA
{
    "name": "Test#2",
    "timeRange": "last_week",
    "then": "whitelist_source",
    "targetFilterListId": 18,
    "conditions": [
        {
            "condition": "when",
            "action": "dspPrice",
            "comparison": "<",
            "value": "1"
        }
    ]
}

10.4.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/optimization-rule/7' -i -X PUT \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJ4U2V2MWNOYUtoYlJFMlIwIiwic3ViIjoiNDkiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.Pe9KdNSnhVqzu7iX6JILYQZI4fNYhOwkwxiYq9OEdS8' \
    -d '{
    "name": "Test#2",
    "timeRange": "last_week",
    "then": "whitelist_source",
    "targetFilterListId": 18,
    "conditions": [
        {
            "condition": "when",
            "action": "dspPrice",
            "comparison": "<",
            "value": "1"
        }
    ]
}'

10.4.4. Response Body

Path Type Description

data.id

integer

Id

data.userId

integer

User Id

data.ownerCampaignId

integer

Campaign id where it was created rule

data.name

string

Name

data.timeRange

string

type: (last_day,last_3_days,last_week,last_month)

data.then

string

type: (whitelist_source,blacklist_source)

data.targetFilterListId

integer

Filter list id

data.conditions

Array

Conditions

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

10.4.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 7,
        "userId": 49,
        "ownerCampaignId": 0,
        "name": "Test#2",
        "timeRange": "last_week",
        "then": "whitelist_source",
        "targetFilterListId": 18,
        "conditions": [],
        "createdAt": "2025-03-26T09:53:40.000000Z",
        "updatedAt": "2025-03-26T09:53:40.000000Z"
    }
}

10.5. Remove Rule assigned to Campaign

A `DELETE` request will delete a Optimization rule relation

10.5.1. HTTP Request

URL

DELETE api/optimization-rule/8 HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJpck1nU2tWNjZWekRzZ05xIiwic3ViIjoiNTAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.rlsu0DNENSoHx0BXg8EtO1aNjGSG3hhRv2OSWd57tF4
Content-type: application/x-www-form-urlencoded
DATA
{}

10.5.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/optimization-rule/8' -i -X DELETE \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MjAsImV4cCI6MTc0Mjk4NjQyMCwibmJmIjoxNzQyOTgyODIwLCJqdGkiOiJpck1nU2tWNjZWekRzZ05xIiwic3ViIjoiNTAiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.rlsu0DNENSoHx0BXg8EtO1aNjGSG3hhRv2OSWd57tF4' \
                -H 'Content-type: application/x-www-form-urlencoded' \
    -d '{}'

10.5.3. Response Body

Path Type Description

deleted

boolean

is deleted

10.5.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "deleted": true
}

11. Assign Optimization rules to Campaigns

11.1. Get Rule assigned to Campaign

A `GET` request will return a optimization rule relation

11.1.1. HTTP Request

URL

GET api/campaign/9/optimization-rule-relation HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJOQWtqYWd1M3FCVm83YjVZIiwic3ViIjoiMTQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.P0YHu8lL0fb6Q5Oktlyvr3K9xuBjK5uUL_5c1amxbkc
DATA
{}

11.1.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaign/9/optimization-rule-relation' -i -X GET \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJOQWtqYWd1M3FCVm83YjVZIiwic3ViIjoiMTQiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.P0YHu8lL0fb6Q5Oktlyvr3K9xuBjK5uUL_5c1amxbkc' \
    -d '{}'

11.1.3. Response Body

Path Type Description

data.id

integer

Id

data.userId

integer

User Id

data.ownerCampaignId

integer

Campaign id where it was created rule

data.name

string

Name

data.timeRange

string

last_day

last_3_days

last_week

last_month

data.then

string

whitelist_source

blacklist_source

data.targetFilterListId

integer

Filter list id

data.conditions.*.condition

string

Condition (when

and

or) first condition must be - when

data.conditions.*.action

string

Actions (ctr

clicks

winrate

impressions

dspSpend)

data.conditions.*.comparison

string

Comparison types (>

<

=)

data.conditions.*.value

string

Value

data.createdAt

datetime

Date of creation

data.updatedAt

datetime

Date of last modification

11.1.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "data": {
        "id": 1,
        "userId": 14,
        "ownerCampaignId": 9,
        "name": "TEST Rule#1",
        "timeRange": "last_week",
        "then": "blacklist_source",
        "targetFilterListId": 1,
        "conditions": [
            {
                "condition": "and",
                "action": "winrate",
                "comparison": ">",
                "value": 5000
            }
        ],
        "createdAt": "2025-03-26T09:53:36.000000Z",
        "updatedAt": "2025-03-26T09:53:36.000000Z"
    }
}

11.2. Replace Rule assigned to Campaign

A `POST` request will return a optimization rule relation

11.2.1. Request Body

Path Type Description Required

campaignId

integer

campaignId

+

ruleId

integer

ruleId

+

11.2.2. HTTP Request

URL

POST api/campaign/optimization-rule-relation HTTP/1.1

HEADER
Accept: application/json
Content-type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiI2cXkxWEVlbXJZeHNkeHVNIiwic3ViIjoiMTUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.h5vX1-OTe0W7lQ7q2PB6mPJVRsogUpIosiw4RLWLnTs
DATA
{
    "campaignId": 10,
    "ruleId": 2
}

11.2.3. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaign/optimization-rule-relation' -i -X POST \
            -H 'Accept: application/json' \
                -H 'Content-type: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiI2cXkxWEVlbXJZeHNkeHVNIiwic3ViIjoiMTUiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.h5vX1-OTe0W7lQ7q2PB6mPJVRsogUpIosiw4RLWLnTs' \
    -d '{
    "campaignId": 10,
    "ruleId": 2
}'

11.2.4. Response Body

Path Type Description

campaignId

integer

campaignId

ruleId

integer

ruleId

11.2.5. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "campaignId": 0,
    "ruleId": 2
}

11.3. Remove Rule assigned to Campaign

A `DELETE` request will delete a Optimization rule relation

11.3.1. HTTP Request

URL

DELETE api/campaign/11/optimization-rule-relation HTTP/1.1

HEADER
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJKRmJVTm9WcURDYzIyVFFXIiwic3ViIjoiMTYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.8zCcsz1K8MD16Eum4n6Inhmjea9OE9K_-ilAIObOOOw
Content-type: application/x-www-form-urlencoded
DATA
{}

11.3.2. Curl request

$ curl 'https://dsp-api.smartyads.com/api/campaign/11/optimization-rule-relation' -i -X DELETE \
            -H 'Accept: application/json' \
                -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0Ojk5MjMiLCJpYXQiOjE3NDI5ODI4MTYsImV4cCI6MTc0Mjk4NjQxNiwibmJmIjoxNzQyOTgyODE2LCJqdGkiOiJKRmJVTm9WcURDYzIyVFFXIiwic3ViIjoiMTYiLCJwcnYiOiIyM2JkNWM4OTQ5ZjYwMGFkYjM5ZTcwMWM0MDA4NzJkYjdhNTk3NmY3In0.8zCcsz1K8MD16Eum4n6Inhmjea9OE9K_-ilAIObOOOw' \
                -H 'Content-type: application/x-www-form-urlencoded' \
    -d '{}'

11.3.3. Response Body

Path Type Description

deleted

boolean

is deleted

11.3.4. HTTP Response

HTTP/1.0 200 OK
    Content-type: application/json
    Access-control-allow-origin: *
    X-ratelimit-limit: 500
    X-ratelimit-remaining: 499
{
    "deleted": true
}

Postman collection

Request validation list

Campaign.contentCategories
  • IAB1

  • IAB2

  • IAB3

  • IAB4

  • IAB5

  • IAB6

  • IAB7

  • IAB8

  • IAB9

  • IAB10

  • IAB11

  • IAB12

  • IAB13

  • IAB14

  • IAB15

  • IAB16

  • IAB17

  • IAB18

  • IAB19

  • IAB20

  • IAB21

  • IAB22

  • IAB23

    Campaign.connectionTypes
  • wifi

  • ethernet

  • cellular_all

  • cellular_all

  • cellular_3g

  • cellular_4g

Campaign.OS

  • 'Android',

  • 'Android 8.0',

  • 'Android 8.1',

  • 'Android 9.0',

  • 'Android 10.0',

  • 'Android 11.0',

  • 'Android 12.0',

  • 'Android 13.0',

  • 'Android 14.0',

  • 'iOS',

  • 'iOS 10.0',

  • 'iOS 10.1',

  • 'iOS 10.2',

  • 'iOS 10.3',

  • 'iOS 11.0',

  • 'iOS 11.1',

  • 'iOS 11.2',

  • 'iOS 11.3',

  • 'iOS 12.0',

  • 'iOS 12.1',

  • 'iOS 12.2',

  • 'iOS 12.3',

  • 'iOS 12.4',

  • 'iOS 13.1',

  • 'iOS 13.2',

  • 'iOS 13.3',

  • 'iOS 13.4',

  • 'iOS 13.5',

  • 'iOS 13.6',

  • 'iOS 14.0',

  • 'iOS 14.1',

  • 'iOS 14.2',

  • 'iOS 14.3',

  • 'iOS 14.4',

  • 'iOS 14.5',

  • 'iOS 14.6',

  • 'iOS 14.7',

  • 'iOS 14.8',

  • 'iOS 15.0',

  • 'iOS 15.1',

  • 'iOS 15.2',

  • 'iOS 15.3',

  • 'iOS 15.4',

  • 'iOS 15.5',

  • 'iOS 15.6',

  • 'iOS 15.7',

  • 'iOS 16.0',

  • 'iOS 16.1',

  • 'iOS 16.2',

  • 'iOS 16.3',

  • 'iOS 16.4',

  • 'Mac OS',

  • 'Mac OS 10.1',

  • 'Mac OS 10.2',

  • 'Mac OS 10.3',

  • 'Mac OS 10.4',

  • 'Mac OS 10.5',

  • 'Mac OS 10.6',

  • 'Mac OS 10.7',

  • 'Mac OS 10.8',

  • 'Mac OS 10.9',

  • 'Mac OS 10.10',

  • 'Mac OS 10.11',

  • 'Mac OS 10.12',

  • 'Mac OS 10.13',

  • 'Mac OS 10.14',

  • 'Mac OS 10.15',

  • 'Mac OS 11.0',

  • 'Mac OS 11.1',

  • 'Mac OS 11.2',

  • 'Mac OS 11.3',

  • 'Mac OS 11.4',

  • 'Mac OS 11.5',

  • 'Mac OS 11.6',

  • 'Mac OS 12.0',

  • 'Mac OS 12.1',

  • 'Mac OS 12.2',

  • 'Mac OS 12.3',

  • 'Mac OS 12.4',

  • 'Mac OS 12.5',

  • 'Mac OS 12.6',

  • 'Mac OS 13.0',

  • 'Mac OS 13.1',

  • 'Mac OS 13.2',

  • 'BlackBerry',

  • 'Linux',

  • 'Windows',

  • 'Windows 8.1',

  • 'Windows 10',

  • 'Windows 11',

  • 'Windows Mobile',

  • 'Symbian',

  • 'Symbian 9.1',

  • 'Symbian 9.2',

  • 'Symbian 9.3',

  • 'Symbian 9.4',

     Campaign.browser
    * 'Chrome',
    * 'Edge',
    * 'IE',
    * 'Safari',
    * 'Mozilla',
    * 'Opera',
    * 'UCBrowser',
    * 'Yandex',