Skip to content

themoviedb.org API

themoviedb.org has 4 public methods: get movie details, list trending movies and TV shows, get TV show details and list upcoming theatrical movies in a country. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

themoviedb.org (opens in a new tab)

Unofficial. Not affiliated with or endorsed by themoviedb.org.

Methods

4

  • Get movie details

    Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country.

    Returns title, original title, tagline, overview, release date, age rating, runtime, genres, user score, votes, budget, revenue, language, directors, writers, cast, trailers, where to watch, poster and backdrop images, TMDB link and ID

    Readthemoviedb.org/get_movie

  • List trending movies and TV shows

    Lists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those.

    Returns rank, title, year, type, user score, overview, poster link, TMDB link

    Readthemoviedb.org/list_trending

  • Get TV show details

    Finds a TV show on TMDB by exact name or TMDB show link and returns its details, cast, seasons, the last aired and next scheduled episodes, and the streaming services listed for a chosen country.

    Returns name, overview, first and last air dates, status, next and last episodes, season and episode counts, seasons, networks, creators, cast, genres, user score, where to watch, poster, TMDB link and ID

    Readthemoviedb.org/get_tv_show

  • List upcoming theatrical movies in a country

    Lists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score.

    Returns title, release date, genres, overview, user score, poster link, TMDB link

    Readthemoviedb.org/list_upcoming_movies