Skip to content
aioratings aioratings

Quickstart

You need an API key and an image URL. That’s it.

1. Get a key

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

Free keys work immediately and serve the default poster with every rating source available. Premium/Pro keys add the custom drag-and-drop canvas designer and saved profiles — see Plans & limits.

2. Build a poster URL

Section titled “2. Build a poster URL”

The drop-in base URL and URL shape:

https://api.aioratings.com/{key}/{idType}/poster-default/{id}.jpg
  • {key} — your aioratings API key.
  • {idType} — imdb, tmdb or tvdb.
  • poster-default — the built-in poster style. Premium/Pro can swap in a custom profile.
  • {id} — the title id, matching {idType} (see URL shape & idTypes).
  • .jpg — the file extension (.png is also accepted).

Working example

Section titled “Working example”

tt0903747 is Breaking Bad:

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

Open it in a browser (with your real key) and you’ll get a poster image with a clean rating strip along the bottom — official provider logos, dynamic Rotten Tomatoes icons, and a top-right Oscar/Emmy statuette if the title won an award. No styling parameters needed; the default look matches openposterdb.com.

3. Try a few parameters

Section titled “3. Try a few parameters”

Filter and reorder the rating badges, and pick the artwork source:

https://api.aioratings.com/YOUR_KEY/imdb/poster-default/tt0903747.jpg?ratings_order=imdb,rt&image_source=t

Every parameter is documented in Query parameters.

4. Wire it into a tool

Section titled “4. Wire it into a tool”

Pick your platform and follow the copy-paste config: