.intro-content {
    text-align: center;
    margin: 2em;
}

.intro-content h1 {
    font-size: 36px;
    font-weight: 600;
}

.intro-content p {
    margin-top: 0.5em;
    font-size: 28px;
    color: #12B6DC;
    font-weight: 500;
}

.intro-cards {
    margin: 0 2em;
}

.mint-block {
    display: block
}
.mint-hidden {
    display: none
}
.dark\:mint-block:is(.dark *) {
    display: block
}
.dark\:mint-hidden:is(.dark *) {
    display: none
}

Welcome to the home of your new documentation

Introduction

TMDB-API-Docs

Home

API Reference

Quick Reference Guide

Changelog

Login

Service Status

Support

Language specific Libraries for TMDB built by community members

Wrappers and Libraries

List of commonly used words on TMDB and their meaning

Glossary

FAQs

Miscellenous

Welcome to V3 of TMDB API reference. Here, you will find a list of methods currently available for our movie, tv, actor and image API.

Learn how to get the right credential for your authentication

Obtain API key

Authentication

Below is an overview of all endpoints currently available on TMDB

Endpoints overview

Below is a list of errors you may come across while using TMDB

Error codes & Rate limits

This endpoint allows you to create a new session for a guest user.

Create guest session

This endpoint allows you to create a temporary request token that can be used to validate a TMDB user login.

Create request token

This endpoint allows you to create a fully valid session ID once a user has validated the request token.

Create session ID

This endpoint allows you to test if your API key is valid.

Validate API key

This endpoint allows you to mark a movie or TV show as a favourite.

Add favourite

This endpoint allows you to add a movie or TV show to your watchlist.

Add to watchlist

This endpoint allows you to get the public details of an account on TMDB.

Fetch account details

This endpoint allows you to get a user's list of custom playlists.

List custom playlist

StartFragment

This endpoint allows you to get a user's list of favourite movies.

List favourite movies

This endpoint allows you to get a user's list of favourite TV shows.

List favourite TV shows

This endpoint allows you to get a user's list of rated movies.

List rated movies

This endpoint allows you to get a user's list of rated TV episodes.

List rated TV Episodes

This endpoint allows you to get a user's list of rated TV shows.

List rated TV shows

This endpoint allows you to get a list of movies added to a user's watchlist.

List watchlisted movies

This endpoint allows you to get a list of TV shows added to a user's watchlist.

List watchlisted TV shows

This endpoint allows you to get an up-to-date list of the officially supported movie certifications on TMDB.

List movie certifications

This endpoint allows you to get an up-to-date list of the officially supported TV show certifications on TMDB.

List TV certifications

This endpoint allows you to fetch a collection by ID

Fetch collection details

This endpoint allows you to fetch images that belong to a collection.

Fetch collection image

This endpoint allows you to fetch translations in a collection.

Fetch collection translations

This endpoint allows you to fetch list of person IDs that have been changed in the past 24 hours.

List changed persons

This endpoint allows you to fetch list of TV shows that have been changed in the past 24 hours.

List changed TV shows

This endpoint allows you to fetch alternative names for a company.

Fetch alternative names

This endpoint allows you to get the company details by ID.

Fetch company details

This endpoint allows you to get the company logos by id.

Fetch company logos

This endpoint allows you to get the list of countries used throughout TMDB.

List countries

This endpoint allows you to get the list of the jobs and departments used on TMDB.

List jobs

This endpoint allows you to get the list of languages used throught TMDB

List languages

This endpoint allows you to get a list of the officially supported translations on TMDB.

List primary translations

This endpoint allows you to get the list of timezones used throughout TMDB.

List timezones

This endpoint allows you to query the API configuration details.

Query configuration details

This endpoint allows you to get a movie or TV credit details by ID.

Fetch credit details

This endpoint allows you to find movies using over 30 filters and sort options.

Discover movies with filters

This endpoint allows you to find TV shows using over 30 filters and sort options.

Discover TV with filters

This endpoint allows you to find data by external IDs.

Find by ID

This endpoint allows you to get the list of official genres for movies.

List movie genre

This endpoint allows you to get the list of official genres for TV shows.

List TV genre

This endpoint allows you to get keyword details using an ID

Fetch keyword details

This endpoint allows you to get a list of movies that are currently in theatres.

Fetch now playing

This endpoint allows you to get a list of movies by their order of popularity.

Fetch popular

This endpoint allows you to get a list of movies by their order of rating.

Fetch top rated

This endpoint allows you to get a list of movies that are being released soon.

Fetch upcoming

This endpoint allows you to rate a movie and save it to your rated list.

Add rating

This endpoint allows you to delete a user rating.

Delete rating

This endpoint allows you to get the rating, watchlist, and favorite status of an account.

Fetch account states

This endpoint allows you to get the alternative titles for a movie.

Fetch alternative titles

This endpoint allows you to get external IDs of a movie.

Fetch external IDs

This endpoint allows you to get the newest movie ID.

Fetch latest movie

This endpoint allows you to get the recent changes for a movie.

Fetch movie changes

This endpoint allows you to get the credits of the movie.

Fetch movie credits

This endpoint allows you to get the top-level details of a movie by ID.

Fetch movie details

This endpoint allows you to get the images that belong to a movie.

Fetch movie images

This endpoint allows you to get a list of keyword that have been added to a movie.

Fetch movie keywords

This endpoint allows you to get the lists that a movie has been added to.

Fetch movie List

This endpoint allows you to fetch movie recommendations.

Fetch movie recommendations

This endpoint allows you to get the translations for a movie.

Fetch movie translation

This endpoint allows you to get the release dates and certifications for a movie.

Fetch release dates

This endpoint allows you to get similar movies based on genres and keywords.

Fetch similar movies

This endpoint allows you to get the user reviews for a movie.

Fetch user reviews

This endpoint allows you to get the videos that belong to a movie.

Fetch videos

This endpoint allows you to get a list of streaming providers for a movie.

Fetch watch providers

This endpoint allows you to get alternative names of the networks.

This endpoint allows you to get the details of a network using an ID.

Fetch details

This endpoint allows you to get TV network logos by ID.

Fetch images

This endpoint allows you to get the combined movie and TV credits that belong to a person.

Fetch combined credits

This endpoint allows you to query the top-level details of a person.

This endpoint allows you to get the external ID's that belong to a person.

This endpoint allows you to get the newest created person.

Fetch latest

This endpoint allows you to get the movie credits for a person.

This endpoint allows you to get the profile images that belong to a person.

Fetch person image

This endpoint allows you to get the recent changes for a person.

Fetch recent changes

This endpoint allows you to get the TV credits that belong to a person.

Fetch TV credits

This endpoint allows you to get a list of people ordered by popularity.

This endpoint allows you to retrieve the details of a movie or TV show review.

Fetch review details

This endpoint allows you to search for keywords by their name.

Search by keyword

This endpoint allows you to search for collections by their original, translated, and alternative names.

Search collection

This endpoint allows you to search for companies by their original and alternative names.

Search company

This endpoint allows you to search for movies by their original, translated, and alternative titles.

Search movies

This endpoint allows you to use multi-search for movies, TV shows, and people in a single request.

Search multi options

This endpoint allows you to search for people by their names and known-as names.

Search people

This endpoint allows you to search for TV shows by their original, translated, and known-as names.

Search TV

This endpoint allows you to get the trending movies, TV shows, and people.

Fetch all Trendings

This endpoint allows you to get the trending movies on TMDB.

Fetch trending movies

This endpoint allows you to get the trending people on TMDB.

Fetch trending people

This endpoint allows you to get the trending TV shows on TMDB.

Fetch trending TVs

This endpoint allows you to get the details of a TV episode group.

This endpoint allows you to rate a TV episode and save it to your rated list.

This endpoint allows you to delete your rating on a TV episode.

This endpoint allows you to get the rating, watchlist, and favorite status of an episode.

This endpoint allows you to get the recent changes for a TV episode.

Fetch changes

This endpoint allows you to get credits for an episode.

Fetch episode credits

This endpoint allows you to query the details of a TV episode.

Welcome to TMDB API documentation

Introduction

Obtain API key

Authentication

Endpoints Overview

Errors & Rate Limits

FAQs