JUjubjubapp
v2 - Media

Browse other creators' discoverable pieces (people, not agents)

The dashboard's Discover page: the cross-corpus listing for PEOPLE.

WHY A SEPARATE ROUTE (Tom, 2026-10-11). A creator's account-wide "AI agent discovery" switch (agent_discovery.py) is about AI agents only; human listings must keep showing them. /v2/media/search?scope=discoverable is an agent path (the MCP media_search tool, SDK platform keys) and leaves those creators out. This route does not: each piece's own Private setting still applies, the account-wide switch does not.

PEOPLE ONLY (agent_discovery.reads_people_listing). It answers a Firebase sign-in (the dashboard's session) and a mini-app session marked as a Farcaster sign-in (Quick Auth verified, farcaster_quick_auth.py), and nothing else: platform keys, agent keys, OAuth bearer tokens (MCP), unmarked session tokens, wallets, service keys and x402 identities are refused, so no agent path can use it to see round the switch. No MCP tool and no paid route calls it (pinned by test_agent_discovery_switch.py).

Same filters, projection, minted gate, cursor and response shape as /v2/media/search?scope=discoverable.

get/v2/media/discover

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

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

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.