Get all creatives

Get the Creative Library creatives of an account. Supports filtering by status and by creative ID, pagination, and sorting.

See also: Creative Library overview.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Overview

Get the Creative Library creatives of an account. The response is a paginated results list of creative objects.

GET /backstage/api/1.0/demo-advertiser/creatives?statuses=ACTIVE&page=1&page_size=2
{
  "results": [
    {
      "id": 4321000001,
      "name": "Summer sale hero",
      "account_id": "demo-advertiser",
      "status": "ACTIVE",
      "creative_type": "STATIC_IMAGE",
      "url": "https://www.demo-advertiser.com/summer-sale",
      "thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/summer-sale.jpg",
      "title": "Summer sale: up to 50% off",
      "description": "Limited-time offer on the full summer collection",
      "cta": {
        "cta_type": "SHOP_NOW"
      },
      "orientation": "HORIZONTAL",
      "create_time_in_utc": "2026-09-01 10:15:30",
      "custom_id": "SS-2026-HERO",
      "ads": {
        "ads": [
          {
            "id": 8765000101,
            "campaign_id": 33,
            "campaign_name": "Summer sale - US",
            "creative_id": 4321000001
          }
        ]
      }
    },
    {
      "id": 4321000002,
      "name": "Summer sale motion",
      "account_id": "demo-advertiser",
      "status": "ACTIVE",
      "creative_type": "PERFORMANCE_VIDEO",
      "url": "https://www.demo-advertiser.com/summer-sale",
      "title": "Summer sale: up to 50% off",
      "performance_video_data": {
        "video_url": "https://cdn.demo-advertiser.com/video/summer-sale.mp4",
        "fallback_url": "https://cdn.demo-advertiser.com/video/summer-sale-fallback.jpg"
      },
      "orientation": "HORIZONTAL",
      "create_time_in_utc": "2026-09-02 08:40:12",
      "ads": null
    }
  ],
  "metadata": {
    "total": 14,
    "count": 2
  }
}
📘

Query parameters

  1. statuses - comma-separated creative statuses to return (ACTIVE, CRAWLING, NEED_TO_EDIT, TERMINATED). Omit to return every status except TERMINATED: deleted creatives are returned only when statuses includes TERMINATED.
  2. creative_ids - comma-separated creative IDs to return.
  3. page and page_size - pagination. Pass both or neither; passing only one returns 400.
  4. sort - the field to sort by, in snake_case (for example create_time_in_utc). Sorting on a field that does not exist returns 400.
📘

Response body

The results list holds one creative object per creative. Fields that are not set for a creative are returned as null (omitted above for brevity). The ads object lists the ads created from the creative and is null for an unassigned creative.

📘

See also

Rate limit

🚧

Rate limit

Tier 4. Counted per account, across all of the account's users.

See Rate limits for the request allowance each tier carries.

Path Params
string
required

An alphabetic ID. See Get Account Details.

Query Params
string

Comma-separated list of creative statuses to return: ACTIVE, CRAWLING, NEED_TO_EDIT, TERMINATED. Omit to return every status except TERMINATED.

string

Comma-separated list of creative IDs to return.

integer

1-based page number. Must be passed together with page_size.

integer

Number of creatives per page. Must be passed together with page.

string

Field to sort by, in snake case (for example create_time_in_utc).

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Choose an example:
application/json