---
title: "creatives.searchByImage for a picture sent in the request instead of linked: `image` is the base64 of a JPEG, PNG or WebP of at most 5 MB, `mime_type` its type. Crop a screenshot to the creative itself first (uncropped phone screenshots found their creative 10 times in 30 in the bake-off, cropped ones 30 in 30). Only creatives with an embedding are searched. A daily budget caps these searches across the API; past it the answer is 429 until the next UTC day."
method: POST
path: "/v1/workspaces/{ws}/creative-search/image"
tags: ["creatives"]
---

# creatives.searchByImage for a picture sent in the request instead of linked: \`image\` is the base64 of a JPEG, PNG or WebP of at most 5 MB, \`mime_type\` its type. Crop a screenshot to the creative itself first (uncropped phone screenshots found their creative 10 times in 30 in the bake-off, cropped ones 30 in 30). Only creatives with an embedding are searched. A daily budget caps these searches across the API; past it the answer is 429 until the next UTC day.

`POST /v1/workspaces/{ws}/creative-search/image`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/workspaces/{ws}/creative-search/image`
- Auth: HTTP bearer

creatives.searchByImage for a picture sent in the request instead of linked: `image` is the base64 of a JPEG, PNG or WebP of at most 5 MB, `mime_type` its type. Crop a screenshot to the creative itself first (uncropped phone screenshots found their creative 10 times in 30 in the bake-off, cropped ones 30 in 30). Only creatives with an embedding are searched. A daily budget caps these searches across the API; past it the answer is 429 until the next UTC day. Scope `creatives:write`; cache `none`.

## Path parameters

- `ws` string, required

## Request body

- object
  - `image` string, required
  - `mime_type` 'image/jpeg' | 'image/png' | 'image/webp', required
  - `brand_id` union
    - string, uuid
    - string
  - `category_id` string, uuid
  - `limit` integer

## Response `201`

Success.

- object
  - `data` object, required
    - `embed_version` string, required
    - `items` 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
      - `similarity` number, 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)