---
title: "Search creative records (one per stored file, not per ad) by brand or category, analysis depth, media kind, language, speech kind, any of the values of each closed field, words said or written on screen, and numeric ranges; most live ads first. Counts are ads carrying a file, never spend."
method: GET
path: "/v1/creative-records"
tags: ["creatives"]
---

# Search creative records (one per stored file, not per ad) by brand or category, analysis depth, media kind, language, speech kind, any of the values of each closed field, words said or written on screen, and numeric ranges; most live ads first. Counts are ads carrying a file, never spend.

`GET /v1/creative-records`

## Request

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

Search creative records (one per stored file, not per ad) by brand or category, analysis depth, media kind, language, speech kind, any of the values of each closed field, words said or written on screen, and numeric ranges; most live ads first. Counts are ads carrying a file, never spend. Scope `creatives:read`; cache `daily`.

## Query parameters

- `limit` integer
- `cursor` string
- `brand_id` union
  - string, uuid
  - string
- `category_id` string, uuid
- `depth` string[]
- `kind` 'video' | 'image'
- `audience_gender` string[]
- `audience_life_stage` string[]
- `desire` string[]
- `awareness` string[]
- `hook_trigger` string[]
- `lead_type` string[]
- `narrative_form` string[]
- `emotional_driver` string[]
- `format` string[]
- `production` string[]
- `offer_type` string[]
- `stage` string[]
- `said` string
- `on_screen` string
- `q` string
- `language` string
- `speech_kind` 'speech' | 'music-only' | 'silent'
- `brand_said_s_min` number
- `brand_said_s_max` number
- `product_shown_s_min` number
- `product_shown_s_max` number
- `length_s_min` number
- `length_s_max` number
- `running_days_min` integer
- `running_days_max` integer
- `ads_min` integer
- `ads_max` integer
- `confidence_min` number
- `confidence_max` number
- `sort` 'ads' | 'newest' | 'running'

## Response `200`

A page; `meta.cursor` is present when more follow.

- object
  - `data` object[], required
    - `key` string, required
    - `kind` 'video' | 'image', required
    - `depth` 'described' | 'labelled' | 'transcribed' | 'probed', required
    - `brand_id` string, uuid, required
    - `brand` object, nullable, required
      - `id` string, uuid, required
      - `slug` string, required
      - `name` string, required
      - `domain` string, required
      - `logo_url` string, uri, nullable, required
    - `file_key` string, required
    - `preview_key` string, nullable, required
    - `duration_s` number, nullable, required
    - `aspect` string, nullable, required
    - `speech_kind` 'speech' | 'music-only' | 'silent', nullable, required
    - `language` string, nullable, required
    - `hook_line` string, nullable, required
    - `ads_active` integer, required
    - `first_start` string, date, nullable, required
    - `age_days` integer, nullable, required
    - `still_active` boolean, required
    - `tags` object, required
    - `min_confidence` number, nullable, required
    - `pack_version` string, nullable, required
    - `classifier_version` string, nullable, required
    - `matched` object, nullable, required
      - `field` 'said' | 'on_screen', required
      - `text` string, required
      - `at` number, nullable, 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)