Skip to content
aioratings aioratings

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 premium drag-and-drop canvas — choose which badges show and where) and award badges: an Oscar / Emmy winner statuette in the top-right corner, which RPDB doesn’t offer.

Base URL

Section titled “Base URL”
https://api.aioratings.com

api.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 api.aioratings.com and the existing URL shape works unchanged — no /rpdb prefix needed.

Poster URL shape

Section titled “Poster URL shape”
GET https://api.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

Section titled “Working example”
https://api.aioratings.com/YOUR_KEY/imdb/poster-default/tt0903747.jpg

(tt0903747 is Breaking Bad.)

What carries over from RPDB

Section titled “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

Section titled “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 poster with every rating source and the automatic Oscar / Emmy award statuette. Premium / Pro keys add the custom canvas designer and saved profiles (used in the poster-default slot) plus higher call limits. See Plans & limits.

A note on key privacy in URLs

Section titled “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.