AI
AIOratings

API Documentation

Generate custom movie and TV show posters programmatically

Quick Start

Get started with the Poster Generation API in minutes

1. Get your API key from the Dashboard

2. Make a request to generate a poster

https://apiv2.aioratings.com/api/EVOzOUDVOfdfcBdcjweVsNJiNMuQJPpsYUWJsYUBiSqHONyqCRbXzlkQJUnMWRpV/imdb/default/tt0903747.jpg

Base URL

https://apiv2.aioratings.com

Poster Generation

Generate Poster
GET

Endpoint

GET https://apiv2.aioratings.com/api/{apiKey}/{idType}/{profileID}/{mediaID}.jpg

Path Parameters

apiKey

Your API key from the dashboard

idType

Database type: imdb or tmdb

profileID

Profile identifier: default or custom profile UUID

Premium required for custom profiles

mediaID

Media identifier format depends on idType:

  • IMDb: tt0903747
  • TMDB Movie: movie-550
  • TMDB TV: tv-1396

Example Request

GET https://apiv2.aioratings.com/api/EVOzOUDVOfdfcBdcjweVsNJiNMuQJPpsYUWJsYUBiSqHONyqCRbXzlkQJUnMWRpV/imdb/default/tt0903747.jpg

Response

Returns a JPEG image file

Content-Type: image/jpeg

User Tiers & Profile Access

Free Tier
  • Access to default profile
  • All basic poster generation features
  • Standard caching benefits
Premium Tier
$4.99/month
  • Access to default + custom profiles
  • User-specific poster layouts (up to 10 profiles)
  • Priority caching for custom profiles
  • Enhanced customization options

Error Responses

401

Unauthorized

Invalid or expired API key

403

Forbidden

Custom profile access requires premium subscription

404

Not Found

Profile or media not found

Need Help?

Check your API Keys or explore Custom Profiles