Developer Mode

Integration readiness dashboard.

These adapters are mocked today. They define the contracts MULOME can use later for Spotify, YouTube, TMDB, and AI enrichment.

Back to app

TMDB status

TMDB API key missing, using mock data

Movie and series search now uses real TMDB data when TMDB_API_KEY is configured, with mocked fallback for safe demos.

Open TMDB diagnostics

Watch providers

Provider availability is normalized for user regions.

Search cards and detail pages can now show stream, rent, and buy options with TMDB data or mock fallback.

Open provider diagnostics

YouTube discovery

Video discovery now covers trailers, lore, reviews, and music.

Search and detail pages can now show YouTube videos with real API data or safe mock fallback.

Open YouTube diagnostics

YouTube account OAuth

Google OAuth can unlock private YouTube taste signals.

The account path uses read-only scopes, safe prototype cookies, and mocked fallback when env vars or API calls are missing.

Open account diagnostics

Spotify

Mock adapter for playlists, tracks, soundtrack paths, and taste signals.

mocked

Auth type: OAuth

Environment keys

SPOTIFY_CLIENT_IDSPOTIFY_CLIENT_SECRETSPOTIFY_REDIRECT_URI

YouTube

Mock adapter for trailers, interviews, explainers, and creator videos.

mocked

Auth type: API key

Environment keys

YOUTUBE_API_KEY

TMDB

Mock adapter for movie and series metadata, posters, genres, and similar titles.

mocked

Auth type: API key

Environment keys

TMDB_API_KEY

Connected platforms

Netflix

Video

Connected

Prime Video

Video

Connected

Spotify

Music

Connected

YouTube

Creator

Connected

Next API steps

Add OAuth routes for Spotify account linking and token refresh.

Store encrypted provider tokens after user consent.

Connect TMDB search, recommendations, images, and watch providers.

Connect YouTube search for trailers, interviews, and explainers.

Use OpenAI to rank normalized provider results against Taste DNA.

Mocked API responses

Spotify

Example query: John Wick

{
  "tasteData": {
    "source": "spotify",
    "topGenres": [
      "soundtrack",
      "synthwave",
      "anime rock",
      "dark ambient"
    ],
    "topCreators": [
      "Ludwig Goransson",
      "Kavinsky",
      "Yoko Kanno"
    ],
    "topItems": [
      "Atmospheric Score Radio",
      "Hidden Leaf Training Mix",
      "John Wick: Club Mix"
    ],
    "signals": [
      "listens after watching",
      "saves cinematic playlists",
      "likes high energy action mixes"
    ]
  },
  "searchResults": [
    {
      "id": "spotify-john-wick-club",
      "source": "spotify",
      "title": "John Wick: Club Mix",
      "type": "playlist",
      "platform": "Spotify",
      "description": "Electronic and club tracks inspired by neon action scenes."
    },
    {
      "id": "spotify-atmospheric-score-radio",
      "source": "spotify",
      "title": "Atmospheric Score Radio",
      "type": "playlist",
      "platform": "Spotify",
      "description": "Cinematic tracks for dark drama, sci-fi, and focus sessions."
    }
  ],
  "relatedContent": {
    "id": "John Wick",
    "source": "spotify",
    "relatedTitles": [
      "Drive",
      "John Wick",
      "Cyberpunk: Edgerunners"
    ],
    "relatedMusic": [
      "Neon action radio",
      "Anime battle themes",
      "Ambient mystery scores"
    ],
    "relatedVideos": [
      "Composer interviews",
      "Soundtrack essays"
    ],
    "similarIds": [
      "score-radio",
      "john-wick-soundtrack",
      "hidden-leaf-radio"
    ]
  },
  "deepLink": "https://open.spotify.com/search/John%20Wick"
}

YouTube

Example query: John Wick

{
  "tasteData": {
    "source": "youtube",
    "topGenres": [
      "trailers",
      "lore explainers",
      "interviews",
      "fight breakdowns"
    ],
    "topCreators": [
      "Film essay channels",
      "Anime lore creators",
      "Trailer channels"
    ],
    "topItems": [
      "Naruto Lore Explained",
      "John Wick Fight Design",
      "Cyberpunk ending explained"
    ],
    "signals": [
      "watches explainers after shows",
      "opens interviews after movies",
      "uses trailers before saving"
    ]
  },
  "searchResults": [
    {
      "id": "youtube-john-wick-fight-design",
      "source": "youtube",
      "title": "John Wick Fight Design",
      "type": "video",
      "platform": "YouTube",
      "description": "Fight choreography interviews and stunt design breakdowns."
    },
    {
      "id": "youtube-trailer-path",
      "source": "youtube",
      "title": "Trailer and interview path",
      "type": "video",
      "platform": "YouTube",
      "description": "A mocked video lane for trailers, creator context, and cast interviews."
    }
  ],
  "relatedContent": {
    "id": "John Wick",
    "source": "youtube",
    "relatedTitles": [
      "Naruto",
      "John Wick",
      "Drive"
    ],
    "relatedMusic": [
      "Trailer scores",
      "Anime opening themes"
    ],
    "relatedVideos": [
      "Lore explainers",
      "Fight design interviews",
      "Soundtrack video essays"
    ],
    "similarIds": [
      "naruto-lore",
      "john-wick-interviews",
      "shinobi-games"
    ]
  },
  "deepLink": "https://www.youtube.com/results?search_query=John%20Wick"
}

TMDB

Example query: John Wick

{
  "tasteData": {
    "source": "tmdb",
    "topGenres": [
      "crime",
      "anime",
      "action",
      "science fiction"
    ],
    "topCreators": [
      "Chad Stahelski",
      "Vince Gilligan",
      "Studio Trigger"
    ],
    "topItems": [
      "John Wick",
      "Dark",
      "Cyberpunk: Edgerunners"
    ],
    "signals": [
      "opens similar films",
      "saves dark dramas",
      "searches franchise collections"
    ]
  },
  "searchResults": [
    {
      "id": "tmdb-john-wick",
      "source": "tmdb",
      "title": "John Wick",
      "type": "movie",
      "platform": "TMDB",
      "description": "Movie metadata, franchise entries, images, and similar action films."
    },
    {
      "id": "tmdb-dark",
      "source": "tmdb",
      "title": "Dark",
      "type": "series",
      "platform": "TMDB",
      "description": "Series metadata and similar mystery recommendations."
    }
  ],
  "relatedContent": {
    "id": "John Wick",
    "source": "tmdb",
    "relatedTitles": [
      "The Raid",
      "Drive",
      "Boardwalk Empire"
    ],
    "relatedMusic": [
      "Soundtrack search handoff to Spotify"
    ],
    "relatedVideos": [
      "Trailer handoff to YouTube",
      "Cast interview handoff"
    ],
    "similarIds": [
      "the-raid",
      "great-soundtrack-drive",
      "boardwalk-empire"
    ]
  },
  "deepLink": "https://www.themoviedb.org/search?query=John%20Wick"
}