URL shape & idTypes

The URL shape

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

Segment	Values	Notes
`{key}`	your API key, or `h.{hash}`	The hashed form fetches posters but is not an account credential.
`{idType}`	`imdb` · `tmdb` · `tvdb`	See the table below.
`{style}`	`poster-default`, or a profile	`poster-default` is the built-in style; custom profiles are premium/pro.
`{id}`	the title id	Format depends on `{idType}`.
`.{jpg\|png}`	`.jpg` or `.png`	`.jpg` is the default; `.png` is a distinct cache key.

Supported idTypes and media-id formats

idType	mediaId format	Example
`imdb`	IMDb id, with or without the `tt` prefix	`tt0903747` or `0903747`
`tmdb`	`movie-{id}` or `tv-{id}`	`movie-1396`, `tv-1396`
`tvdb`	TVDB numeric id	`81189`

Notes:

For imdb, the leading tt is optional — the API normalizes it.
For tmdb, you must include the media-type prefix (movie- or tv-), because a TMDB numeric id alone is ambiguous between a movie and a TV show.
The id may also carry movie- / series- / episode- prefixes (RPDB style); these are tolerated and normalized.

Endpoint families

poster-default is the poster endpoint. The forked OpenPosterDB engine also exposes backdrop, logo and episode-still endpoints — see Endpoints for the full list and their URL shapes.

File extension behavior

.jpg — default; widely compatible with every media tool.
.png — opt-in; a distinct cache key that returns PNG bytes when you need a guaranteed lossless image (e.g. logos with transparency).