Skip to content

Plans & limits

import { LinkButton } from “@astrojs/starlight/components”;

aioratings is a drop-in RatingPosterDB replacement that adds two things RPDB doesn’t: a custom poster designer (a drag-and-drop canvas where you choose which rating/award badges appear and where, saved as reusable profiles) and award badges (Oscar / Emmy / Golden Globe winners, sourced from IMDb).

The free tier works immediately — wire aioratings into Stremio, Plex or Kometa with zero friction — then upgrade for the designer, more rating sources, and award badges.

Get a free key

TierPriceRating sourcesDesigner / profilesAward badges
Free$0IMDb, Rotten Tomatoes, TMDBNo — default style onlyNo
Premium$4.99/mo · $40/yr (early-bird, ~33% off annual)All: IMDb, Rotten Tomatoes, Metacritic, Letterboxd, TMDBYes — custom canvas + up to ~10 profiles, assignable per keyYes
ProContact / see dashboardAll sourcesYesYes

“Lifetime” is a billing offer (a one-time purchase of premium/pro access), not a separate capability tier.

  • Rating sources. Free keys are limited to the free source set (IMDb, Rotten Tomatoes, TMDB); a free key’s ratings_order request is ignored and always returns that set. Premium/Pro keys get all sources and can filter and reorder with the rating parameters.
  • Custom profiles / the designer. Only premium/pro keys can use a non-default style in the poster URL (a custom profile). Free keys are restricted to poster-default (a custom profile returns 403). Premium/pro can also assign a default profile to a key in the dashboard so plain poster-default URLs render the assigned design.
  • Award badges. Premium feature — surfaced in the Stremio addon (the Awards card is premium-only) and via premium poster profiles.

Premium and Pro are gated identically in the request path today (both unlock custom profiles + all sources). Any finer Pro differentiation is a product/UI distinction.

Every ratings/poster request is logged, and a daily roll-up aggregates per-user monthly usage. The per-tier API-call allowances shown on the pricing page are the published limits; the isValid endpoint reports a key’s limit (the tier monthly quota; 0 = unlimited) and its live requestCount.

  • Checkout is via Stripe, initiated from the pricing page (monthly / annual toggle). Success returns to the billing dashboard.
  • Your account tier (free / premium / pro) is stored on the user and read on every API request to gate sources and profiles as above.
Manage your plan