---
title: "A sample of the brand's active ads with stored media (half the longest-running, half the newest; at most `sample`, answered as sample_cap), plus format, CTA and longevity totals over every active ad."
method: GET
path: "/v1/brands/{brandId}/creative-library"
tags: ["brands"]
---

# A sample of the brand's active ads with stored media (half the longest-running, half the newest; at most \`sample\`, answered as sample_cap), plus format, CTA and longevity totals over every active ad.

`GET /v1/brands/{brandId}/creative-library`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/brands/{brandId}/creative-library`
- Auth: HTTP bearer

A sample of the brand's active ads with stored media (half the longest-running, half the newest; at most `sample`, answered as sample_cap), plus format, CTA and longevity totals over every active ad. Scope `brands:read`; cache `daily`.

## Path parameters

- `brandId` union, required
  - string, uuid
  - string

## Query parameters

- `sample` integer

## Response `200`

Success.

- object
  - `data` object, required
    - `ads` object[], required
      - `id` string, required
      - `page_id` string, required
      - `page_name` string, required
      - `title` string, nullable, required
      - `body_text` string, nullable, required
      - `cta_text` string, nullable, required
      - `link_url` string, nullable, required
      - `caption` string, nullable, required
      - `format` 'video' | 'image' | 'carousel' | 'dco' | 'other', required
      - `started` string, date, required
      - `first_seen` string, date, required
      - `last_seen` string, date, required
      - `days_observed` integer, required
      - `versions` integer, required
      - `platforms` string[], required
      - `countries` string[], required
      - `branded` boolean, required
      - `preview_key` string, nullable, required
      - `video_key` string, nullable, required
      - `images` integer, required
    - `sample_cap` integer, required
    - `mix` object, required
      - `active` integer, required
      - `video` integer, required
      - `proven30` integer, required
      - `proven90` integer, required
      - `longest` integer, required
    - `ctas` object[], required
      - `cta` string, required
      - `ads` integer, required
    - `longevity` object[], required
      - `bucket` 'Under a week' | '1–4 weeks' | '1–3 months' | 'Over 3 months', required
      - `ads` integer, required
    - `as_of` string, date-time, required
  - `meta` object, required
    - `request_id` string, required
    - `as_of` string, date-time, required
    - `lag_hours` number
    - `cursor` string
    - `count` integer

## Other responses

- `4XX`: The one error shape.
- `5XX`: The one error shape.

---

[API](https://skmtc.dev/scrollstash/apis/storequant-api.md) · [All operations](https://skmtc.dev/scrollstash/apis/storequant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrollstash/apis/storequant-api/revisions/4d67a114a13c?raw)