---
title: "brands.creativeLibrary for many brands in one read: each brand's sample of active ads with stored media and its totals over every active ad, as brands.creativeLibrary answers them. Every public brand asked is answered, in the order asked."
method: GET
path: "/v1/brand-creative-library"
tags: ["brands"]
---

# brands.creativeLibrary for many brands in one read: each brand's sample of active ads with stored media and its totals over every active ad, as brands.creativeLibrary answers them. Every public brand asked is answered, in the order asked.

`GET /v1/brand-creative-library`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/brand-creative-library`
- Auth: HTTP bearer

brands.creativeLibrary for many brands in one read: each brand's sample of active ads with stored media and its totals over every active ad, as brands.creativeLibrary answers them. Every public brand asked is answered, in the order asked. Scope `brands:read`; cache `daily`.

## Query parameters

- `brands` string, required
- `sample` integer

## Response `200`

Success.

- object
  - `data` object[], required
    - `brand_id` string, uuid, required
    - `slug` string, required
    - `library` 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/c556e643d689?raw)