Stunning Ratings.
Stateless API.

Generate dynamic posters and backdrops for your Addons. No accounts, no tokens, just beautiful imagery via query parameters.

Configuration

Adjust parameters to see the preview update in real-time.

Type
Media ID
Add TMDB key for lang
Style
Text
Poster Layout
Max/side
Providers

Preview Output

Stateless dynamic layout generated via query parameters.

No preview available.

Addon Proxy

Paste a Stremio addon manifest to generate a new manifest that always uses ERDB images.

ERDB parameters
Providers
Type
Add TMDB key for lang
Poster Style
Poster Text
Poster Layout
Max/side
Backdrop Layout

Generated Manifest

Use this URL in Stremio. It ends with manifest.json and has no query params.

https://erdb.example.com/proxy/{config}/manifest.json
Open

Add manifest URL, TMDB key and MDBList key to generate a valid link.

Always replace images
Proxy rewrites `meta.poster`, `meta.background`, `meta.logo` for both `catalog` and `meta` responses.

Developers

Stateless rendering for any media ID.

Dynamic Rendering

No tokens needed. Pass parameters in the query string and let ERDB handle metadata and rendering.

Addon Friendly

Perfect for Stremio, Kodi or any media center addon. Use simple URL patterns for easy integration in your code.

API Reference

ParameterValuesDefault
type (path)poster, backdrop, logo
id (path)IMDb, TMDB, Kitsu, etc.
ratingstmdb, mdblist, imdb, tomatoes, letterboxd, metacritic, trakt, myanimelist, anilist, kitsuall
langen, it, es, fr, de, pt, ru, ja, zh, tren
ratingStyleglass, square, plainglass (poster/backdrop), plain (logo)
imageTextoriginal, clean, alternativeoriginal (poster), clean (backdrop)
posterRatingsLayouttop, bottom, left, right, top-bottom, left-righttop-bottom
posterRatingsMaxPerSide1-20auto
backdropRatingsLayoutcenter, right, right-verticalcenter
tmdbKey (req)TMDB v3 API Key
mdblistKey (req)MDBList.com API Key

Type Configs

TypeConfigLayouts / Values
poster
imageText
posterRatingsLayout
posterRatingsMaxPerSide
original, clean, alternative
top, bottom, left, right, top-bottom, left-right
1-20 (auto if omitted)
backdrop
imageText
backdropRatingsLayout
original, clean, alternative
center, right, right-vertical
logonone (base params only)
Base params for all types: ratings, lang, ratingStyle, tmdbKey, mdblistKey.

ID Formats

SourceFormatExample
IMDbtt + numberstt0133093
TMDBtmdb:idtmdb:603
Kitsukitsu:idkitsu:1
Animeprovider:idanilist:123, mal:456

Base Structure

http://localhost:3000/{type}/{id}.jpg?ratings={ratings}&lang={lang}&ratingStyle={style}&imageText={text}&posterRatingsLayout={layout}&posterRatingsMaxPerSide={max}&backdropRatingsLayout={bLayout}&tmdbKey={tmdbKey}&mdblistKey={mdbKey}
lang (optional):All TMDB ISO 639-1 codes are supported (en, it, fr, es, de, etc.). Default: en.
id (required):IMDb ID (tt...), TMDB ID (tmdb:...), or Kitsu ID (kitsu:...).
tmdbKey (required):Your TMDB v3 API Key.
mdblistKey (required):Your MDBList API Key.

AI Developer Prompt

Copy this prompt to help an AI agent implement this API in your addon.

Act as an expert addon developer. I want to implement the ERDB Stateless API into my media center addon. API Base URL: (YOUR_API_BASE_URL) Base URL must be entered during configuration and must remain editable (do not hardcode or lock it). --- FULL API REFERENCE --- Endpoint: GET /{type}/{id}.jpg?...queryParams Parameter | Values | Default type (path) | poster, backdrop, logo | — id (path) | IMDb (tt...), TMDB (tmdb:id), Kitsu (kitsu:id), AniList, MAL | — ratings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, | all | metacritic, metacriticuser, trakt, rogerebert, myanimelist, | | anilist, kitsu | lang | Any TMDB ISO 639-1 code (en, it, fr, es, de, ja, ko, etc.) | en ratingStyle | glass, square, plain | glass (poster/backdrop), plain (logo) imageText | original, clean, alternative | original (poster), clean (backdrop) posterRatingsLayout | top, bottom, left, right, top-bottom, left-right | top-bottom posterRatingsMaxPerSide | Number (1-20) | auto backdropRatingsLayout | center, right, right-vertical | center tmdbKey (REQUIRED) | Your TMDB v3 API Key | — mdblistKey (REQUIRED) | Your MDBList.com API Key | — --- TYPE-SPECIFIC CONFIGS --- poster: - imageText: original, clean, alternative - ratingStyle: glass, square, plain (per-type override) - posterRatingsLayout: top, bottom, left, right, top-bottom, left-right - posterRatingsMaxPerSide: 1-20 (auto if omitted) backdrop: - imageText: original, clean, alternative - ratingStyle: glass, square, plain (per-type override) - backdropRatingsLayout: center, right, right-vertical logo: - ratingStyle: glass, square, plain (per-type override) - no extra layout config (base params only) --- INTEGRATION REQUIREMENTS --- 1. Settings panel with all parameters above. 2. Add a "Setup" button that opens a modal containing the full configuration UI (keep the main page clean). 3. Settings MUST be per-type (poster/backdrop/logo). Do NOT use global settings for ratings, lang, style, imageText, or layouts. When a user selects a type, show ONLY that type’s settings. 4. Image Text MUST be configured separately for poster and backdrop. 5. Global required fields: ERDB API Base URL, TMDB API Key, MDBList API Key. 6. Language MUST be a selectable list (dropdown) of TMDB ISO 639-1 codes, not a free text input. 7. Live Preview that updates instantly. 8. Dynamic URL: /{type}/{id}.jpg?tmdbKey=...&mdblistKey=...&ratings=...&lang=...&ratingStyle=...&imageText=...

Live Examples

// Movie Poster (IMDb)
http://localhost:3000/poster/tt0133093.jpg?ratings=imdb,tmdb&ratingStyle=plain
// Backdrop (TMDB)
http://localhost:3000/backdrop/tmdb:603.jpg?ratings=mdblist&backdropRatingsLayout=right-vertical