Creative Options

Origin-picker autocomplete. Carries the taxonomy the task form copies onto a new draft, so picking an origin needs no second request for the full creative.

GET/api/v1/creatives/options

Authorization

AuthorizationBearer token · headerrequired

AuthorizationOAuth2 access token · headerrequired

Query parameters

searchstring | any

case-insensitive match on name

limitinteger

min 1 · max 50 · default: 10

exclude_idsstring[] | any

already-chosen creatives, never returned

product_idstring | any

restrict candidates to one product

Responses

200Successful Response

successboolean

default: true

dataCreativeOption[] | any

Show properties

Any of:

CreativeOption[]

Array of CreativeOption

idstringrequired

labelstringrequired

preview_urlstring | any

Show properties

Any of:

string

string

any

any

work_streamWorkStreamrequired

Allowed:PerformanceProductWebBrandSMMHR

product_idstringrequired

media_typeMediaTyperequired

Allowed:VIDSTAANIWEBLNDENDC

resolutionResolution | any

Show properties

Any of:

Resolution

string

any

any

sourceSource | any

Show properties

Any of:

Source

string

any

any

geoGeo | any

Show properties

Any of:

Geo

string

any

any

languageLanguage | any

Show properties

Any of:

Language

string

any

any

any

any

messagestring | any

Show properties

Any of:

string

string

any

any

errorsstring[] | any

Show properties

Any of:

string[]

Array of string

string

any

any

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X GET "/api/v1/creatives/options" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("/api/v1/creatives/options", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "/api/v1/creatives/options",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "success": true,
  "data": [
    {
      "id": "string",
      "label": "string",
      "preview_url": "string",
      "work_stream": "Performance",
      "product_id": "string",
      "media_type": "VID",
      "resolution": "1080x1920",
      "source": "META",
      "geo": "US",
      "language": "EN"
    }
  ],
  "message": "string",
  "errors": [
    "string"
  ]
}