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 available (beta)

An artwork add-on that upgrades your existing library: it walks your movies, fetches our country-aware primary poster for each and sets it — your metadata scraper stays untouched. Optional auto-run after every library update. Install it from our add-on repository below.

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.

Install in Kodi (beta)

  1. Enable Settings → System → Add-ons → Unknown sources, then install our repository zip via Install from zip file.
  2. Install from repository → MoviePosterDB Repository → install MoviePosterDB Artwork.
  3. Add-on settings: paste your API key, optionally set your preferred poster country.
  4. Run it from Program add-ons — it fills in posters for your whole movie library. Or enable the automatic run after every library update.

Artwork only, by design: your metadata scraper keeps doing its job, we just upgrade the posters. Movies are matched via the IMDb/TMDB ids already in your library.

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 (600–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 preview size (s_, 200 px).

Good to know: movies are our core, but the archive covers TV series too — curated artwork for over 100,000 series and counting. We serve our own posters and data; plot summaries and cast stay with your existing metadata provider.

Create your API key →Read the API docs