TOP Posters Developer API

📚 API Reference

Every endpoint, parameter and response, with code samples in 20+ languages. Calls can be tried straight from the browser.

Open the reference

📋 Changelog

What changed, and when. Worth a look before integrating, and after each release.

View the changelog

❓ FAQ

How badges, languages, thumbnails, logos and banners behave, and how they wire into Stremio, Plex, Jellyfin and Emby.

Read the FAQ

🚀 Quick Start

The API key is the first segment of the path, and id_type is one of imdb, tmdb, tvdb, trakt, mal, kitsu, anilist or anidb. YOUR_API_KEY stands in for a real key.

Poster

Vertical artwork with up to three rating badges and an optional trend indicator.

# The Shawshank Redemption, by IMDb ID
curl -o poster.jpg \
  "https://api.top-posters.com/YOUR_API_KEY/imdb/poster/tt0111161.jpg"

Banner

16:9 horizontal artwork with the title logo placed automatically and up to five rating badges. Off by default; enabled in Dashboard → Banners.

# Game of Thrones, by TMDB ID
curl -o banner.jpg \
  "https://api.top-posters.com/YOUR_API_KEY/tmdb/banner/series-1399.jpg"

Episode thumbnail

The episode still, with a rating for that episode rather than the series average.

# Breaking Bad, season 1 episode 1
curl -o thumbnail.jpg \
  "https://api.top-posters.com/YOUR_API_KEY/imdb/thumbnail/tt0903747/S1E1.jpg"

Title logo

A transparent PNG of the title logo with its own rating badges below. Off by default; enabled in Dashboard → Logos.

# Fight Club, by TMDB ID
curl -o logo.png \
  "https://api.top-posters.com/YOUR_API_KEY/tmdb/logo/movie-550.png"
The URL never changes. Language, badges, style, position, size and resolution live in the dashboard, not in the query string. A change there applies to URLs already in circulation: each one serves the new look on its next cache miss. The only per-request parameters are fallback_url and user_agent everywhere, plus trend and badges on posters, badges on banners and blur on thumbnails.