Skip to main content
GET
List advertiser creative library

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

advertiserId
string
required

Advertiser ID

Minimum string length: 1

Query Parameters

Search by name

Maximum string length: 200
promoted
enum<string>

When "true", return only promoted creative-library items (those with a creative_role of evergreen or reference). Flight-specific creatives are excluded.

Available options:
true,
false
role
enum<string>

Filter to a single library role: evergreen or reference (the shelf's two tabs). Implies promoted; narrower than promoted=true.

Available options:
evergreen,
reference
source
enum<string>

Filter by provenance: uploaded (A), generated (B), or connected (C).

Available options:
uploaded,
generated,
connected
format_kind
string

Filter by AdCP 3.1 canonical format kind (e.g. image_carousel, video_hosted).

Required string length: 1 - 255
asset_type
enum<string>

Filter to creatives that carry at least one asset of this type.

Available options:
IMAGE,
VIDEO,
AUDIO,
HTML,
JAVASCRIPT,
CSS,
TEXT,
URL,
VAST,
FONT,
LOGO,
DOCUMENT
dimensions
string

Filter to creatives with an asset of these pixel dimensions, "WIDTHxHEIGHT" (e.g. "300x250").

Pattern: ^\d{1,5}[x×]\d{1,5}$
take
integer
default:50

Number of results to return (max 250)

Required range: 1 <= x <= 250
Example:

50

skip
integer
default:0

Number of results to skip for pagination

Required range: 0 <= x <= 9007199254740991
Example:

0

Response

List advertiser creative library

Paginated list of creative manifest summaries

manifests
object[]
required

Manifests projected to the summary shape. Use get_creative for full detail.

total
integer
required
Required range: 0 <= x <= 9007199254740991