TMDB API
The Movie Database (TMDB)
A user-built movie and TV database with budgets, cast, posters, and where-to-stream data.
The API to The Movie Database, a community-edited catalog of films, TV series, and people. Records include titles, release dates by country, genres, cast and crew, budgets and revenue where known, keywords, images, ratings, and streaming availability (via JustWatch). It is the most common free source for movie metadata in apps and analysis projects.
Access
- Cost
- Free tier, paid upgradesFree API key for non-commercial use with attribution; commercial use requires a separate agreement.
- License
- Provider's own termsTMDB API terms of use
- Sign-up
- Free account
- How you get it
- APIJSON
What's in it
- One row is
- One record per movie, TV series, season, episode, or person
- Covers
- Titles from worldwide, with localized data
- Years
- 1890s-present
- Updated
- Real time
- Size
- Over a million movies
Quality
Broad, current, and well documented, but community-entered fields like budget and revenue are often missing or unsourced.
- Budget and revenue figures are sparse and unverified
- Daily ID exports exist but full records require API calls
Connects to
- IMDb Non-Commercial Datasets: Join on IMDb IDs for ratings and credits
- MovieLens: Its links file maps MovieLens movie IDs to TMDB IDs
Questions it could answer
- Which genres earn the highest revenue relative to budget?
- How has the number of films released per year changed by country?