---
title: "creatives.record for many creatives in one read, by full key: each record as creatives.record answers it, in the order asked. A key no stage holds yet, or whose brand is not public, is left out."
method: GET
path: "/v1/creative-records/batch"
tags: ["creatives"]
---

# creatives.record for many creatives in one read, by full key: each record as creatives.record answers it, in the order asked. A key no stage holds yet, or whose brand is not public, is left out.

`GET /v1/creative-records/batch`

## Request

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

creatives.record for many creatives in one read, by full key: each record as creatives.record answers it, in the order asked. A key no stage holds yet, or whose brand is not public, is left out. Scope `creatives:read`; cache `daily`.

## Query parameters

- `keys` string, required

## Response `200`

Success.

- object
  - `data` object[], required
    - `key` string, required
    - `kind` 'video' | 'image', required
    - `depth` 'described' | 'labelled' | 'transcribed' | 'probed', required
    - `brand` object, required
      - `id` string, uuid, required
      - `slug` string, required
      - `name` string, required
      - `domain` string, required
      - `logo_url` string, uri, nullable, required
    - `file` object, required
      - `key` string, required
      - `bytes` integer, required
    - `preview_key` string, nullable, required
    - `versions` object, required
      - `pack_version` string, nullable, required
      - `classifier_version` string, nullable, required
      - `transcript_engine_version` string, nullable, required
      - `probe_version` string, nullable, required
    - `as_of` string, date-time, required
    - `ad` object, nullable, required
      - `id` string, required
      - `title` string, nullable, required
      - `body` string, nullable, required
      - `cta` string, nullable, required
      - `link` string, nullable, required
    - `corpus` object, required
      - `ads_using` integer, required
      - `ads_active` integer, required
      - `first_start` string, date, nullable, required
      - `age_days` integer, nullable, required
      - `still_active` boolean, required
      - `landing_page` string, nullable, required
      - `cta_button` string, nullable, required
      - `creator_run` boolean, required
    - `media` object, nullable, required
      - `duration_s` number, nullable, required
      - `width` integer, required
      - `height` integer, required
      - `aspect` string, required
      - `has_audio` boolean, required
      - `frame_ms` integer[], required
    - `transcript` object, nullable, required
      - `engine` string, required
      - `language` string, required
      - `speech_kind` 'speech' | 'music-only' | 'silent', required
      - `speech_share` number, required
      - `text` string, required
      - `segments` object[], required
        - `start` number, required
        - `end` number, required
        - `text` string, required
      - `corrections` object[], required
        - `t` number, required
        - `from` string, required
        - `to` string, required
        - `source` string, nullable, required
    - `intel` object, nullable, required
      - `status` 'ok' | 'failed', required
      - `rich` 'ready' | 'pending' | 'unavailable', required
      - `error` string, nullable, required
      - `classified_at` string, date-time, required
      - `model_id` string, required
      - `tags` object, required
      - `tag_lists` object, required
        - `offer_mechanic` string[], required
        - `urgency` string[], required
        - `ai_elements` string[], required
      - `confidences` object, required
      - `min_confidence` number, required
      - `needs_review` string[], required
      - `unresolved` string[], required
      - `stage` string, nullable, required
      - `ai_disclosure` string, nullable, required
      - `opening` object, required
        - `spoken_0_3s` string, nullable, required
        - `on_screen_text_0_3s` string, nullable, required
        - `first_frame` string, nullable, required
        - `face_in_first_frame` boolean, required
        - `brand_first_spoken_s` number, nullable, required
        - `product_first_shown_s` number, nullable, required
      - `on_screen_text` string, nullable, required
      - `message` object, required
        - `persona` string, nullable, required
        - `theme` string, nullable, required
        - `mechanism_as_stated` string, nullable, required
        - `claims` string[], required
        - `proof` string, nullable, required
        - `objections_handled` string[], required
        - `style_note` string, nullable, required
        - `summary` string, nullable, required
      - `offer` object, nullable, required
        - `headline` string, nullable, required
        - `price_shown` string, nullable, required
        - `anchor_price` string, nullable, required
        - `guarantee` string, nullable, required
        - `cta_spoken` string, nullable, required
        - `mechanics` string[], required
        - `urgency` string[], required
      - `structure` object[], required
        - `beat` string, required
        - `t` number[], required
        - `text` string, nullable, required
      - `scenes` object[], required
        - `t` number, required
        - `shot` string, required
      - `findings` object[], required
        - `rule` string, required
        - `note` string, required
        - `severity` 'contradiction' | 'info' | 'note', required
      - `products_shown` string[], 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.

## Changes

- **2026-10-19** `4fbe9d681caf`: 1 info
  - for the `query` request parameter `keys`, the minLength was decreased from `64` to `10`

[Operation history](https://skmtc.dev/scrollstash/apis/storequant-api/changes/v1/creative-records/batch/get.md)

---

[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)