ReelDB

Simple movie & TV metadata API.

Search titles, fetch ratings, get cast and crew, streaming providers, seasons, episodes, and OMDb-compatible responses from one clean JSON API.

Base URL: https://api.reeldb.io | Get an API key at reeldb.io

Quick Start

curl "https://api.reeldb.io/v1/title?imdb=tt0133093&apikey=YOUR_KEY"

{
  "ids": { "imdb": "tt0133093", "tmdb": 603, "trakt": 481, "mdblist": "the-matrix" },
  "title": "The Matrix",
  "year": 1999,
  "type": "movie",
  "certification": "R",
  "runtime": 136,
  "genres": ["Action", "Science Fiction"],
  "ratings": {
    "imdb":       { "rating": 8.7, "votes": 2100000 },
    "tomatoes":   { "rating": 83,  "certified_fresh": true },
    "metacritic": { "rating": 73 },
    "trakt":      { "rating": 8.5, "votes": 45000 },
    "tmdb":       { "rating": 8.2, "votes": 25000 },
    "letterboxd": { "rating": 4.2, "votes": 1800000 }
  }
}

Features

• Rich metadata - titles, release dates, runtime, genres, posters, trailers, production data, and IDs.
• Ratings - IMDb, Rotten Tomatoes, Metacritic, Trakt, TMDb, Letterboxd, Roger Ebert, MyAnimeList, MDBList, and more when available.
• Flexible IDs - lookup by IMDb ID, TMDb ID, title text, or path-based title IDs for subresources.
• Append data - request cast, streaming providers, and seasons in a single call with ?append=cast,providers,seasons.
• OMDb compatibility - /omdb supports OMDb-style lookup, search, season, and episode responses.
• TV series - seasons, episodes, air dates, next/last air date, and network data.
• Streaming providers - availability grouped by region and offer type.

Search

curl "https://api.reeldb.io/v1/search?q=matrix&type=movie&apikey=YOUR_KEY"

Parameter	Description
q	Required. Search query (minimum 2 characters).
type	Optional. movie or series.
y	Optional. Release year filter.
page	Optional. Defaults to 1, 10 results per page.

Title Lookup

curl "https://api.reeldb.io/v1/title?imdb=tt0133093&apikey=YOUR_KEY"
curl "https://api.reeldb.io/v1/title?tmdb=603&apikey=YOUR_KEY"
curl "https://api.reeldb.io/v1/title?t=The+Matrix&type=movie&apikey=YOUR_KEY"

Append extra data in one request:

curl "https://api.reeldb.io/v1/title?imdb=tt0133093&append=cast,providers,seasons&apikey=YOUR_KEY"

Path-Based Endpoints

Subresources accept IMDb IDs (tt0133093), TMDb IDs (603), MDBList slugs (the-matrix), or an explicit supported ID type:

curl "https://api.reeldb.io/v1/title/tt0133093/ratings?apikey=YOUR_KEY"
curl "https://api.reeldb.io/v1/title/tt0133093/cast?apikey=YOUR_KEY"
curl "https://api.reeldb.io/v1/title/tt0133093/providers?apikey=YOUR_KEY"
curl "https://api.reeldb.io/v1/title/tt0944947/seasons?apikey=YOUR_KEY"
curl "https://api.reeldb.io/v1/title/tt0944947/seasons/1?apikey=YOUR_KEY"

Override ID auto-detection with ?id_type=imdb|tmdb|trakt|tvdb|mal|mdblist.

OMDb Compatibility

Use ReelDB as an OMDb-compatible movie and TV API endpoint:

# By IMDb ID
curl "https://api.reeldb.io/omdb?i=tt0133093&apikey=YOUR_KEY"

# By title
curl "https://api.reeldb.io/omdb?t=The+Matrix&type=movie&apikey=YOUR_KEY"

# Search
curl "https://api.reeldb.io/omdb?s=batman&page=1&apikey=YOUR_KEY"

# TV episode
curl "https://api.reeldb.io/omdb?i=tt0944947&Season=1&Episode=1&apikey=YOUR_KEY"

Supported parameters: i, t, s, type, y, plot (short/full), Season, Episode, page.

Rate Limits

All requests require an apikey query parameter. Responses include:

Header	Description
X-RateLimit-Limit	Daily request limit for the key
X-RateLimit-Remaining	Remaining requests today

Free keys are available at reeldb.io. Patreon supporters receive higher limits after connecting their account.

Examples

Code examples for common use cases:

• Python
• Node.js
• PHP
• curl

Documentation

• API reference
• OMDb compatibility
• Rate limits
• OpenAPI spec
• SDK links