---
title: "Search media by extracted metadata"
method: GET
path: "/v2/media/search"
tags: ["v2 - Media"]
---

# Search media by extracted metadata

`GET /v2/media/search`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/media/search`
- Auth: HTTP bearer

Structured search over AI-extracted media metadata (media_search_index_v1).

include_unanalysed (discoverable scope only): also return minted pieces
indexed with no extracted metadata, registered imports. A viewer surface
can send people to the platform; an agent buying metadata cannot use them,
so the default leaves them out.
Free for human users — pure indexed filters, no inference.

scope:
  - "mine" (default): your own catalogue, scoped to created_by.
  - "discoverable": cross-corpus, only content whose owner opted in.

cursor: opaque bookmark from a previous discoverable response's
next_cursor — pass it back verbatim to continue. Ignored for scope=mine
(owner corpora fit one page).

Returns content cards (content_id, title, thumbnail_id, thumbnail_url,
facets) matching ALL supplied filters. Topic matches if it appears in the
content's topics.

## Query parameters

- `scope` string
- `domain` string, nullable
- `sub_domain` string, nullable
- `content_type` string, nullable
- `pacing` string, nullable
- `movement_intensity` string, nullable
- `thumbnail_dominant_colour` string, nullable
- `topic` string, nullable
- `face_present` boolean, nullable
- `on_screen_text` boolean, nullable
- `music_present` boolean, nullable
- `speech_present` boolean, nullable
- `thumbnail_face_visible` boolean, nullable
- `thumbnail_text_overlay` boolean, nullable
- `thumbnail_action_shot` boolean, nullable
- `limit` integer
- `cursor` string, nullable
- `include_unanalysed` boolean

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)