GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In

[Advertiser] View Advertiser Campaigns

Retrieving All Campaigns at the Advertiser Level

For the Advertiser API, all campaigns for the specified advertiser will be returned.

This includes campaigns that are not currently running as well as those that have been archived.

https://api.criteo.com/legacy/marketing/v1/advertisers/{advertiserId}/campaigns
curl --request GET \
  --url https://api.criteo.com/legacy/marketing/v1/advertisers/1234/campaigns \
  --header 'Accept: application/json'

 

The following is an example of what's returned:

[
  {
    "campaignType": "LowerFunnel",
    "advertiserName": "Advertiser US",
    "categories": [],
    "budgetId": 99999,
    "campaignId": 1234,
    "campaignName": "Web Conversion - Retargeting",
    "advertiserId": 1,
    "campaignStatus": "Running",
    "campaignBid": {
      "bidValue": 1.25,
      "bidCurrency": "USD",
      "bidType": "CPC"
    }
  },
  {
    "campaignType": "MidFunnel",
    "advertiserName": "Advertiser US",
    "categories": [],
    "budgetId": 99998,
    "campaignId": 1235,
    "campaignName": "Web Conversion - Similar Audience",
    "advertiserId": 1,
    "campaignStatus": "Running",
    "campaignBid": {
      "bidValue": .90,
      "bidCurrency": "USD",
      "bidType": "CPC"
    }
  },

 

This same information can be pulled utilizing the Campaign API with the following query:

https://api.criteo.com/legacy/marketing/v1/campaigns?advertiserIds={advertiserIds}

 

Filtering Campaigns

If you would like to filter certain campaigns using the Campaign API, such as those that are running or a specific campaign, the process to do this is documented in the Campaign section.