Drop-in RPDB replacement

aioratings is a drop-in RatingPosterDB (RPDB) replacement. It serves rating-overlaid posters from a single image URL, with the same URL shape RPDB uses, so most tools that accept an RPDB key and base URL can point at aioratings instead — you paste an aioratings API key where the tool asks for an RPDB key.

On top of RPDB-style ratings posters, aioratings adds a custom poster designer (a drag-and-drop canvas — choose which badges show and where) and award badges (Oscar / Emmy / Golden Globe winners, sourced from IMDb).

Base URL

https://rpdb.aioratings.com

rpdb.aioratings.com is a true drop-in host: many RPDB clients build the poster URL from a key plus the RPDB hostname. Replace api.ratingposterdb.com with rpdb.aioratings.com and the existing URL shape works unchanged — no /rpdb prefix needed.

Poster URL shape

GET https://rpdb.aioratings.com/{key}/{idType}/poster-default/{id}.jpg

• {key} — your aioratings API key (see Getting a key).
• {idType} — imdb, tmdb or tvdb (see URL shape & idTypes).
• poster-default — the poster style / profile. Use poster-default for the built-in style; premium/pro keys can use a custom profile here, or assign a default profile to the key in the dashboard and keep using poster-default.
• {id} — the title id, matching {idType}.
• .jpg — the file extension. .png is also accepted.

Working example

https://rpdb.aioratings.com/YOUR_KEY/imdb/poster-default/tt0903747.jpg

(tt0903747 is Breaking Bad.)

What carries over from RPDB

• Same URL shape — /{key}/{idType}/poster-default/{id}.{jpg|png}.
• Same idTypes — imdb, tmdb, tvdb.
• ?fallback=true — accepted; aioratings also always falls back to the plain poster on a cache miss (see How posters render).
• Validity check — an isValid endpoint returns the key’s validity and usage (see Validation & status).
• Query parameters — the full RPDB query-param surface is accepted (rating ordering, badge styling, artwork source, language, textless, and more). See Query parameters.

Getting a key

1. Sign up at the aioratings dashboard and choose Sign up.
2. Go to Dashboard → API Keys and create a key. Copy it when shown.
3. Paste the key into the {key} position of the poster URL, or into whatever field your integration calls the “RPDB key”.

Free keys work immediately and serve the default style with a limited set of rating sources. Premium / Pro keys unlock custom profiles (the poster-default slot), the full set of rating sources, and award badges. See Plans & limits.

A note on key privacy in URLs

Because the key sits in the poster URL, it can be seen by anyone who sees the URL. For sharing, the poster route also accepts a hashed key form — h.{hash} — in the {key} slot, which fetches posters but cannot be used as an account credential and never appears on the ratings/validation endpoints. The dashboard is the source of truth for generating these. See the Discord & Telegram guide for where this matters most.