v2 - Media

Search media by extracted metadata

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.

get/v2/media/search

Request

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

Query parameters

scopestring
domainstring nullable
sub_domainstring nullable
content_typestring nullable
pacingstring nullable
movement_intensitystring nullable
thumbnail_dominant_colourstring nullable
topicstring nullable
face_presentboolean nullable
on_screen_textboolean nullable
music_presentboolean nullable
speech_presentboolean nullable
thumbnail_face_visibleboolean nullable
thumbnail_text_overlayboolean nullable
thumbnail_action_shotboolean nullable
limitinteger
cursorstring nullable
include_unanalysedboolean

Headers

Authorizationstring
X-JubJub-Service-Keystring
X-JubJub-Agent-Keystring
X-JubJub-Platform-Keystring
Originstring
Refererstring
X-JubJub-Trial-Tokenstring

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.