Integrations

Your media server deserves better posters

Plex, Jellyfin, Kodi & co. usually settle for whatever artwork the big metadata databases carry. MoviePosterDB is a curated archive of theatrical one-sheets — original release posters, per-country editions, up to XL resolution. Here’s how to get them into your library.

JellyfinPlugin available (beta)

A native image-provider plugin: pick MoviePosterDB in your library settings and every movie gets our country-aware primary poster in XL. Metadata keeps coming from your existing providers — we add the artwork. Install it from our plugin repository below; Emby follows next.

KodiPlugin planned

An artwork add-on that plugs into the standard movie scrapers as an additional poster source — plus an upstream contribution so MoviePosterDB shows up in the Universal Movie Scraper's site list.

PlexWaiting on Plex

Plex is replacing its legacy agents with HTTP-based custom metadata providers. Our provider endpoint is designed and waits for that API to support authenticated requests — no plugin install needed, you'll just paste a provider URL with your key.

Media managers & scriptsAPI ready today

TinyMediaManager, home-grown scripts, anything that speaks HTTP: the Data API resolves titles by IMDb/TMDB id or filename match and returns ready-to-download poster URLs — usable right now.

Install in Jellyfin (beta)

  1. Dashboard → Plugins → Repositories → add https://movieposterdb.com/jellyfin/manifest.json
  2. Catalog → install MoviePosterDB, then restart Jellyfin.
  3. Plugin settings: paste your API key (mpdb_pk_…), optionally set your preferred poster country.
  4. In your movie library’s settings, enable/prioritise MoviePosterDB under image fetchers — new scans and “refresh metadata” now pull our posters.

The plugin only fetches artwork — your metadata providers stay untouched. Without an API key it stays completely inactive.

What works today

Everything below is live on the Embed Data API — the plugins above are thin wrappers around it:

  • Lookup by the ids your server already has — /movie?imdb=tt0133093 or /movie?tmdb=603, and /match?title=…&year=… for filename-style matching with a confidence score.
  • The right poster first — /posters lists a movie’s approved posters with the (country-aware) primary poster at position 1, so “take the first image” just works.
  • Refresh-friendly quotas — responses carry ETags; periodic library refreshes that hit 304 Not Modified are free.
  • One key for everything — data calls and the poster images themselves are attributed to the same mpdb_pk_… key. No Referer needed, so it works from any server or app.
# resolve by TMDB id, posters included, German primary first
curl -H "Authorization: Bearer mpdb_pk_…" \
  "https://movieposterdb.com/api/embed/v1/movie?tmdb=603&posters=1&country=DE&size=xl&source=jellyfin"

The Personal plan

Built for exactly this: €15 / year unlocks XL posters (~1200 px), 10 GB of image bandwidth and 10,000 API calls per month — comfortably enough to scrape a multi-thousand-movie library and keep it fresh. Non-commercial use only; commercial apps pick one of the publisher tiers. The free tier works too, at up to 600 px (l_).

Good to know: MoviePosterDB is movie-focused — TV series artwork is not our archive’s strength. We serve our own curated posters and data; plot summaries and cast stay with your existing metadata provider.

Create your API key →Read the API docs