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
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
| Parameter | Values | Default |
|---|---|---|
| type (path) | poster, backdrop, logo | — |
| id (path) | IMDb, TMDB, Kitsu, etc. | — |
| ratings | tmdb, mdblist, imdb, tomatoes, letterboxd, metacritic, trakt, myanimelist, anilist, kitsu | all |
| lang | en, it, es, fr, de, pt, ru, ja, zh, tr | 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 | 1-20 | auto |
| backdropRatingsLayout | center, right, right-vertical | center |
| tmdbKey (req) | TMDB v3 API Key | — |
| mdblistKey (req) | MDBList.com API Key | — |
Type Configs
| Type | Config | Layouts / 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 |
| logo | none (base params only) | — |
Base params for all types: ratings, lang, ratingStyle, tmdbKey, mdblistKey.
ID Formats
| Source | Format | Example |
|---|---|---|
| IMDb | tt + numbers | tt0133093 |
| TMDB | tmdb:id | tmdb:603 |
| Kitsu | kitsu:id | kitsu:1 |
| Anime | provider:id | anilist: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