Get Creatives for a Campaign

Get Creatives for a Campaign

Request

GET /campaign/<campaign ID>/creatives

Response

JSON Fields Type Description
messagesObject ArrayAn array of any error messages.
messages[].levelStringError level.
messages[].codeStringError code.
messages[].messageStringError message.
entityObject ArrayAn array of creative objects.
entity[].idNumberCreative ID.
entity[].statusString Status of the creative. It can be one of the following values:
  • INCOMPLETE
  • PENDING
  • APPROVED
  • DISABLED
  • VIOLATION
entity[].nameStringCreative name.
entity[].typeObject
entity[].type.idNumberCreative type ID as shown in the UI.
entity[].type.vendorStringCreative type vendor as shown in the UI.
entity[].type.mediaTypeString Can be one of the following values:
  • BANNER
  • VAST
  • NATIVE
  • MRAID
  • VPAID
  • VAST_WITH_VPAID
entity[].type.videoTypeString Will be null for non-video creative types. Can be on of the following values:
  • FLV
  • MP4
  • WMV
  • WEBM
  • JS
entity[].externalCreativeidString
entity[].crawlableUrlStringCrawlable URL for what the creative is advertising.
entity[].landingPageUrlStringClickthrough URL. May not be final destination.
entity[].impressionTrackingPixel_1StringURL of first tracking pixel.
entity[].impressionTrackingPixel_2StringURL of second tracking pixel.
entity[].impressionTrackingPixel_3StringURL of third tracking pixel.
entity[].impressionTrackingPixel_4StringURL of fourth tracking pixel.
entity[].sizeObject
entity[].size.widthNumberWidth of creative (if applicable).
entity[].size.heightNumberHeight of creative (if applicable).
entity[].channelsString Array Channels selected:
  • MOBILE
  • DESKTOP
entity[].adTagIdStringAdTag identifier. Varies by vendor. Only for AdTag creatives.
entity[].durationNumberCreative duration in seconds (video creatives only).
entity[].bitRateNumberBitrate of creative (video creatives only).

Example

Request to get creatives

curl -u <user>:<password> https://sandbox-api.viant.com/v1/campaign/91/creatives

Response

{
  "messages":[],
  "entity":
   [
    {
      "id":662692,
      "name":"Viant Creative 300x250.gif",
      "type":
      {  "id":1,
         "vendor":"Generic",
         "mediaType":"BANNER",
         "videoType":null
      },
      "status":"APPROVED"
"externalCreativeid": null,
      "crawlableUrl": null,
      "impressionTrackingPixel_1": null,
      "impressionTrackingPixel_2": null,
      "impressionTrackingPixel_3": null,
      "impressionTrackingPixel_4": null,
      "size": {
        "width": 300,
        "height": 250
      },
      "channels": [
        "MOBILE"
      ],
      "landingPageUrl": null,
      "adTagId": null,
      "duration": null,
      "bitRate": null
    }
  ]
}
Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!