get https://backstage.taboola.com/backstage/api/1.0//campaigns/
Get all campaigns for the specified account.
fetch_level
Possible values:
R- Recent: fetch all recent (non-paused) campaigns for the specified account.
RAP- Recent And Paused: fetch all recent campaigns (regardless if paused) for the specified account.In this context, recent means:
a. Created within the last 30 days (regardless of status)
Or
b.status= APPROVED (regardless of creation date)
GET /backstage/api/1.0/demo-advertiser/campaigns/?fetch_level=R
{
"results": [
{
"id": "5750752",
"advertiser_id": "demo-advertiser",
"name": "Demo Campaign 1",
"branding_text": "The best brand",
"tracking_code": "utm_source=taboola&utm_medium=referral",
"pricing_model": "CPC",
"cpc": 0.25,
"safety_rating": null,
"daily_cap": 100,
"daily_ad_delivery_model": "STRICT",
"spending_limit": 5000,
"spending_limit_model": "MONTHLY",
// additional fields...
},
{
"id": "5750753",
"advertiser_id": "demo-advertiser",
"name": "Demo Campaign 2",
"branding_text": "A great brand",
"tracking_code": "utm_source=taboola&utm_medium=referral",
"pricing_model": "CPC",
"cpc": 0.4,
"safety_rating": null,
"daily_cap": 200,
"daily_ad_delivery_model": "STRICT",
"spending_limit": 5000,
"spending_limit_model": "MONTHLY",
// additional fields...
},
// additional campaigns...
],
"metadata": {
//...
}
}
Best practice
Use the
fetch_levelparam to decrease the network payload and shorten the overall response time.
Deleted campaigns
Deleted campaigns (aka terminated campaigns) are not returned.
The network account
- The
campaignsendpoint returns a list of campaigns owned (created) by that account.- Invoking the
campaignsendpoint with your network account will always return 0 results.(This is because the network account is not used to create campaigns.)
- However, you can fetch basic details for all campaigns across the network, using the
campaigns/baseendpoint.