Migrating from RPDB

Migrating an existing RPDB setup to aioratings is usually a one-line change.

The two flavors of RPDB integration

Tools integrate RPDB in one of two ways. Which you have determines the change:

1. The tool lets you set a full poster URL template

Replace the RPDB template with the aioratings one:

https://api.ratingposterdb.com/{key}/{idType}/poster-default/{id}.jpg
https://api.aioratings.com/{key}/{idType}/poster-default/{id}.jpg

…and swap your RPDB key for your aioratings key. Done. This covers Kometa’s mass_poster_url / url_poster, the folder-agent flow, the *arr webhook script, Discord/Telegram embeds, and any tool with a URL field.

2. The tool only takes a key and builds the RPDB host itself

Some tools (certain Stremio aggregators, MDBList) only accept a key and hard-code the RPDB hostname. Because api.aioratings.com mirrors the RPDB URL shape, pointing such a tool at aioratings works when it lets you override the base URL / host; paste your aioratings key in the RPDB key field. If the tool gives you no way to change the host, ask the tool to add aioratings as a provider (or use a URL-template integration instead).

Migration checklist

1. Create an aioratings key in Dashboard → API Keys.
2. In your tool, change the RPDB host to api.aioratings.com (or set the full URL template) and paste your aioratings key.
3. Keep the same {idType} and {id} you used with RPDB — they’re identical (imdb / tmdb / tvdb).
4. Re-run / refresh so posters re-fetch. A brand-new title may show its plain poster once, then upgrade (see How posters render).

What you gain over RPDB

• A custom poster designer (premium) — a drag-and-drop canvas to pick which rating badges show and where, saved as reusable profiles.
• Award statuette — an automatic top-right Oscar / Emmy winner icon, on every tier.
• All MDBList rating sources — IMDb, TMDB, Rotten Tomatoes critic & audience, Metacritic, Trakt, Letterboxd, MyAnimeList, MDBList, Roger Ebert.
• Multiple artwork sources — TMDB and Fanart.tv, plus textless and per-language variants and backdrop/logo/episode-still endpoints.

See the API Reference for everything the engine exposes.