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 the aioratings render 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”