Get All 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 Practices

We recommend using the (optional) fetch_level param. The response will be quicker, and the payload smaller.

πŸ“˜

Deleted Campaigns

Deleted campaigns (aka terminated campaigns) are not returned.

🚧

The network account

  1. You cannot invoke the campaignsendpoint using the network account. Attempting to do so will return 0 results.
  2. You can fetch basic details for all campaigns across the network, using the campaigns/base endpoint (and the network account). See: Get all campaigns across the network

For a detailed overview, see: Network Accounts

Language