Endpoints

Every artwork endpoint shares the same path shape; only the style segment and which parameters are meaningful differ:

GET https://api.aioratings.com/{key}/{idType}/{style}/{id}.{jpg|png}[?params]

{idType} is imdb, tmdb or tvdb; {id} matches it (see URL shape & idTypes). Every parameter referenced below is documented in full on Query parameters.

Poster — poster-default

The headline endpoint: a rated, badged vertical poster (2:3).

GET /{key}/{idType}/poster-default/{id}.jpg

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

With no parameters you get the default look: a clean bottom rating strip (3-per-row, medium badges, official provider logos), the engine’s dynamic Rotten Tomatoes icons, and a top-right Oscar/Emmy statuette for award winners. Add parameters only to deviate from it:

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

Premium/Pro can replace poster-default with a custom profile to apply a saved design.

Common parameters: imageSize, ratings_order, ratings_limit, ratings_exclude, badge_style, badge_size, badge_shape, badge_background, label_style, image_source, lang, textless, position, direction, fit, split, blur, edge_inset, fallback.

Backdrop — backdrop-default

A wide backdrop / fanart image (16:9), optionally rated/badged.

GET /{key}/{idType}/backdrop-default/{id}.jpg

https://api.aioratings.com/YOUR_KEY/tmdb/backdrop-default/series-1396.jpg?image_source=f&textless=true&imageSize=large

Common parameters: imageSize, image_source, lang, textless, blur, fit, plus the badge/rating parameters when you want ratings on a backdrop.

Logo — logo-default

The title’s logo (clearlogo). Request .png for transparency.

GET /{key}/{idType}/logo-default/{id}.png

https://api.aioratings.com/YOUR_KEY/imdb/logo-default/tt0903747.png?image_source=f&lang=en&imageSize=medium

Common parameters: imageSize, image_source, lang. (Rating/badge parameters don’t apply to a bare logo.)

Episode still — episode-default

A still frame for a specific episode.

GET /{key}/{idType}/episode-default/{id}.jpg

For episodes, the id carries the season/episode (RPDB style), e.g. tt0903747:1:1. The episode- prefix on the raw id is also tolerated.

https://api.aioratings.com/YOUR_KEY/imdb/episode-default/tt0903747:1:1.jpg?image_source=t&imageSize=large

Common parameters: imageSize, image_source, lang, blur, fit.

Style fallback

For drop-in compatibility, any unrecognized style segment resolves to the matching -default style for that family, and unknown query parameters are accepted and ignored rather than erroring. This is what lets RPDB clients point at aioratings without modification.