Skip to content
aioratings aioratings

Overview

aioratings serves rating-overlaid movie and TV artwork from a single image URL, the same way RatingPosterDB (RPDB) does. Most tools that already accept an RPDB key and 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 where you choose which rating badges appear and where, saved as reusable profiles; and
  • award badges — a top-right Oscar / Emmy winner statuette (our scraped differentiator), shown automatically and not part of the bottom ratings row.

It is powered by a forked OpenPosterDB engine, so beyond posters it also serves backdrops, logos and episode stills, pulls artwork from multiple sources (TMDB and Fanart.tv, selectable), and supports textless and per-language variants, every image size, and the full RPDB query-param surface.

How the pieces fit

Section titled “How the pieces fit”
PieceWhat it does
API keyIdentifies your account and tier. Sits in the image URL. Create one in Dashboard → API Keys.
Image URLhttps://api.aioratings.com/{key}/{idType}/poster-default/{id}.jpg. Returns a rendered poster (or the plain source poster as a fallback).
Profile / styleThe design applied to the poster. poster-default is the built-in style; premium/pro can use a custom profile.
IntegrationsPlex, Jellyfin, Emby, Kodi, Stremio, Kometa, Radarr/Sonarr, MDBList, Discord/Telegram — each consumes that image URL its own way.

Tiers at a glance

Section titled “Tiers at a glance”
  • Free — works immediately: the default poster, every rating source, and the automatic award statuette. 10,000 image calls / month.
  • Premium / Pro — everything in free, plus the custom canvas designer and saved profiles, with effectively unlimited calls (fair-use cap).

See Plans & limits for the full breakdown.

Next steps

Section titled “Next steps”