---
title: "Browse other creators' discoverable pieces (people, not agents)"
method: GET
path: "/v2/media/discover"
tags: ["v2 - Media"]
---

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

`GET /v2/media/discover`

## 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/discover`
- Auth: HTTP bearer

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.

## Query parameters

- `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

## 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)