ReelDB API

A simple API for movie and series metadata. Fast, reliable, and OMDb-compatible.

Search Find movies and series
Metadata Titles, posters, ratings
Cast & Crew Detailed credit info
Seasons Season & episode data
Providers Streaming availability
OMDb Compatible Drop-in replacement
Get your free API key and start building today.
Join Patreon Connect account
GET REQUEST 
GET https://api.reeldb.io/v1/title/tt0133093?
    apikey=YOUR_KEY

{
  "title": "The Matrix",
  "year": 1999,
  "type": "movie",
  "ratings": { ... },
  "cast": [ ... ],
  "poster": "https://image.reeldb.io/tt0133093.jpg",
  "plot": "A computer hacker learns about the true
    nature of reality..."
}

Documentation

API Reference

All requests require an apikey parameter. Base URL: https://api.reeldb.io

Title ID auto-detection — path-based endpoints accept any of these as {id}:
  • tt1234567 → IMDb ID
  • 603 (digits only) → TMDb ID
  • the-matrix (slug) → MDBList public ID
Add ?id_type=trakt|tvdb|mal|mdblist to use other ID sources.

OMDb Compatible

GET /omdb Drop-in replacement for the OMDb API. Returns the same response shape.
ParameterDescription
iIMDb ID (e.g. tt0133093). Required unless t or s is given.
tTitle search — returns the best match.
sTitle search — returns a list of results.
typemovie or series — filter by media type.
yRelease year filter.
plotshort (default) or full.
SeasonSeason number — returns season data when combined with i.
EpisodeEpisode number — returns episode data when combined with i and Season.
pagePage number for s search results (10 per page).
GET https://api.reeldb.io/omdb?i=tt0133093&apikey=YOUR_KEY
GET https://api.reeldb.io/omdb?t=The+Matrix&type=movie&apikey=YOUR_KEY
GET https://api.reeldb.io/omdb?i=tt0944947&Season=1&Episode=1&apikey=YOUR_KEY

Search

GET /v1/search Search movies and series. Returns paginated results with scores and metadata.
ParameterDescription
q requiredSearch query (minimum 2 characters).
typemovie or series — filter by media type.
yRelease year filter.
pagePage number (10 results per page).
GET https://api.reeldb.io/v1/search?q=matrix&apikey=YOUR_KEY
GET https://api.reeldb.io/v1/search?q=batman&type=movie&y=2022&apikey=YOUR_KEY

Title

GET /v1/title Full title details — includes IDs, direct links to IMDb, Letterboxd, Metacritic, Rotten Tomatoes and more, ratings, and metadata. Use append to include extra data in one request.
ParameterDescription
imdbIMDb ID (e.g. tt0133093).
tmdbTMDb numeric ID.
tTitle string — returns best match.
typemovie or series.
yRelease year filter.
appendComma-separated extras: ratings, cast, providers, seasons. Avoids separate requests.
GET https://api.reeldb.io/v1/title?imdb=tt0133093&apikey=YOUR_KEY
GET https://api.reeldb.io/v1/title?imdb=tt0133093&append=ratings,cast,providers&apikey=YOUR_KEY
GET https://api.reeldb.io/v1/title?tmdb=603&apikey=YOUR_KEY
GET /v1/title/{id}/ratings Ratings from IMDb, Rotten Tomatoes, Metacritic, Trakt, and more. 
GET https://api.reeldb.io/v1/title/tt0133093/ratings?apikey=YOUR_KEY
GET https://api.reeldb.io/v1/title/603/ratings?apikey=YOUR_KEY
GET /v1/title/{id}/cast Full cast and crew with roles, characters, and profile images. 
GET https://api.reeldb.io/v1/title/tt0133093/cast?apikey=YOUR_KEY
GET /v1/title/{id}/providers Streaming availability by region — which services offer the title. 
GET https://api.reeldb.io/v1/title/tt0133093/providers?apikey=YOUR_KEY

Seasons & Episodes

GET /v1/title/{id}/seasons All seasons for a series with episode counts and air dates. 
GET https://api.reeldb.io/v1/title/tt0944947/seasons?apikey=YOUR_KEY
GET /v1/title/{id}/seasons/{n} Episodes for a specific season with titles, air dates, and ratings. 
GET https://api.reeldb.io/v1/title/tt0944947/seasons/1?apikey=YOUR_KEY