TMDB-API-Docs home page
v3 - stable
Search...
⌘K
Service Status
Support
Login
Login
Search...
Navigation
Getting Started
Endpoints overview
Home
API Reference
Quick Reference Guide
Getting Started
Introduction
Obtain API key
Authentication
Endpoints overview
Error codes & Rate limits
Authentication
GET
Create guest session
GET
Create request token
POST
Create session ID
GET
Validate API key
Account
POST
Add favourite
POST
Add to watchlist
GET
Fetch account details
GET
List custom playlist
GET
List favourite movies
GET
List favourite TV shows
GET
List rated movies
GET
List rated TV Episodes
GET
List rated TV shows
GET
List watchlisted movies
GET
List watchlisted TV shows
Certifications
GET
List movie certifications
GET
List TV certifications
Collections
GET
Fetch collection details
GET
Fetch collection image
GET
Fetch collection translations
Changes
GET
List changed persons
GET
List changed TV shows
Companies
GET
Fetch alternative names
GET
Fetch company details
GET
Fetch company logos
Configuration
GET
List countries
GET
List jobs
GET
List languages
GET
List primary translations
GET
List timezones
GET
Query configuration details
Credits
GET
Fetch credit details
Discover
GET
Discover movies with filters
GET
Discover TV with filters
Find
GET
Find by ID
Genres
GET
List movie genre
GET
List TV genre
Keywords
GET
Fetch keyword details
Movie-lists
GET
Fetch now playing
GET
Fetch popular
GET
Fetch top rated
GET
Fetch upcoming
Movies
POST
Add rating
DEL
Delete rating
GET
Fetch account states
GET
Fetch alternative titles
GET
Fetch external IDs
GET
Fetch latest movie
GET
Fetch movie changes
GET
Fetch movie credits
GET
Fetch movie details
GET
Fetch movie images
GET
Fetch movie keywords
GET
Fetch movie List
GET
Fetch movie recommendations
GET
Fetch movie translation
GET
Fetch release dates
GET
Fetch similar movies
GET
Fetch user reviews
GET
Fetch videos
GET
Fetch watch providers
Networks
GET
Fetch alternative names
GET
Fetch details
GET
Fetch images
People
GET
Fetch combined credits
GET
Fetch details
GET
Fetch external IDs
GET
Fetch latest
GET
Fetch movie credits
GET
Fetch person image
GET
Fetch recent changes
GET
Fetch TV credits
People-Lists
GET
Fetch popular
Reviews
GET
Fetch review details
Search
GET
Search by keyword
GET
Search collection
GET
Search company
GET
Search movies
GET
Search multi options
GET
Search people
GET
Search TV
Trending
GET
Fetch all Trendings
GET
Fetch trending movies
GET
Fetch trending people
GET
Fetch trending TVs
Tv-episode-groups
GET
Fetch details
Tv-episodes
POST
Add rating
DEL
Delete rating
GET
Fetch account states
GET
Fetch changes
GET
Fetch episode credits
GET
Fetch episode details
GET
Fetch episode images
GET
Fetch external IDs
GET
Fetch translations
GET
Fetch videos
Tv-seasons
GET
Fetch account states
GET
Fetch aggregate credits
GET
Fetch changes
GET
Fetch external IDs
GET
Fetch images
GET
Fetch season credits
GET
Fetch season details
GET
Fetch translations
GET
Fetch videos
GET
Fetch watch providers
Tv-Series
POST
Add rating
DEL
Delete rating
GET
Fetch account states
GET
Fetch aggregate credits
GET
Fetch alternative titles
GET
Fetch content ratings
GET
Fetch episode groups
GET
Fetch external IDs
GET
Fetch latest TV shows
GET
Fetch reviews
GET
Fetch series images
GET
Fetch similar shows
GET
Fetch theatrically screened
GET
Fetch TV changes
GET
Fetch TV credits
GET
Fetch TV details
GET
Fetch TV keywords
GET
Fetch tv show translations
GET
Fetch tv show videos
GET
Fetch watch providers
GET
List TV series
Tv-Series-List
GET
List airing today
GET
List on the air
GET
List popular tv
GET
List top-rated tv
Watch Providers
GET
Fetch available regions
GET
Fetch movie providers
GET
Fetch TV providers
Authentication
GET
Create guest session
GET
Create request token
POST
Create session ID
GET
Validate API key
Account
GET
Fetch account details
POST
Add favourite
POST
Add to watchlist
GET
List favourite movies
GET
List favourite TV shows
GET
List custom playlist
GET
List rated movies
GET
List rated TV shows
GET
List rated TV Episodes
GET
List watchlisted movies
GET
List watchlisted TV shows
Certifications
GET
List movie certifications
GET
List TV certifications
Changes
GET
List changed persons
GET
List changed TV shows
Collections
GET
Fetch collection details
GET
Fetch collection image
GET
Fetch collection translations
Discover
GET
Discover movies with filters
GET
Discover TV with filters
Configuration
GET
Query configuration details
GET
List countries
GET
List jobs
GET
List languages
GET
List primary translations
GET
List timezones
Movies
GET
Fetch movie details
GET
Fetch account states
GET
Fetch alternative titles
GET
Fetch movie changes
GET
Fetch movie credits
GET
Fetch external IDs
GET
Fetch movie images
GET
Fetch movie keywords
GET
Fetch latest movie
GET
Fetch movie List
GET
Fetch movie recommendations
GET
Fetch release dates
GET
Fetch user reviews
GET
Fetch similar movies
GET
Fetch movie translation
GET
Fetch videos
GET
Fetch watch providers
POST
Add rating
DEL
Delete rating
Companies
GET
Fetch company details
GET
Fetch alternative names
GET
Fetch company logos
Credits
GET
Fetch credit details
Find
GET
Find by ID
Genres
GET
List movie genre
GET
List TV genre
Search
GET
Search collection
GET
Search company
GET
Search by keyword
GET
Search movies
GET
Search multi options
GET
Search people
GET
Search TV
Keywords
GET
Fetch keyword details
Movie Lists
GET
Fetch now playing
GET
Fetch popular
GET
Fetch top rated
GET
Fetch upcoming
Networks
GET
Fetch details
GET
Fetch alternative names
GET
Fetch images
People Lists
GET
Fetch popular
People
GET
Fetch details
GET
Fetch recent changes
GET
Fetch combined credits
GET
Fetch external IDs
GET
Fetch person image
GET
Fetch latest
GET
Fetch movie credits
GET
Fetch TV credits
Reviews
GET
Fetch review details
Trending
GET
Fetch all Trendings
GET
Fetch trending movies
GET
Fetch trending people
GET
Fetch trending TVs
TV Series List
GET
List airing today
GET
List on the air
GET
List popular tv
GET
List top-rated tv
TV Series
GET
Fetch TV details
GET
Fetch account states
GET
Fetch aggregate credits
GET
Fetch alternative titles
GET
Fetch TV changes
GET
Fetch content ratings
GET
Fetch TV credits
GET
Fetch episode groups
GET
Fetch external IDs
GET
Fetch series images
GET
Fetch TV keywords
GET
Fetch latest TV shows
GET
List TV series
GET
Fetch TV recommendations
GET
Fetch reviews
GET
Fetch theatrically screened
GET
Fetch similar shows
GET
Fetch tv show translations
GET
Fetch tv show videos
GET
Fetch watch providers
POST
Add rating
DEL
Delete rating
TV Seasons
GET
Fetch season details
GET
Fetch account states
GET
Fetch aggregate credits
GET
Fetch changes
GET
Fetch season credits
GET
Fetch external IDs
GET
Fetch images
GET
Fetch translations
GET
Fetch videos
GET
Fetch watch providers
TV Episodes
GET
Fetch episode details
GET
Fetch account states
GET
Fetch changes
GET
Fetch episode credits
GET
Fetch external IDs
GET
Fetch episode images
GET
Fetch translations
GET
Fetch videos
POST
Add rating
DEL
Delete rating
TV Episode groups
GET
Fetch details
Watch providers
GET
Fetch available regions
GET
Fetch movie providers
GET
Fetch TV providers
On this page
Base url
Authentication
Account
Certifications
Changes
Collections
Getting Started
Endpoints overview
Below is an overview of all endpoints currently available on TMDB
Base url
Copy
https://api.themoviedb.org/3
Authentication
/authentication/guest_session/new
This endpoint allows you to create a new session for a guest user.
/authentication/token/new
This endpoint allows you to create a temporary request token that can be used to validate a TMDB user login.
/authentication/session/new
This endpoint allows you to create a fully valid session ID once a user has validated the request token.
/authentication
This endpoint allows you to test if your API key is valid.
Account
/account/{account_id}/favorite
This endpoint allows you to mark a movie or TV show as a favourite.
/account/{account_id}/watchlist
This endpoint allows you to add a movie or TV show to your watchlist.
/account/{account_id}
This endpoint allows you to get the public details of an account on TMDB.
/account/{account_id}/lists
This endpoint allows you to get a user’s list of custom playlists.
/account/{account_id}/favorite/movies
This endpoint allows you to get a user’s list of favourite movies.
/account/{account_id}/favorite/tv
This endpoint allows you to get a user’s list of favourite TV shows.
/account/{account_id}/rated/movies
This endpoint allows you to get a user’s list of rated movies.
/account/{{account_id}}/rated/tv/episodes
This endpoint allows you to get a user’s list of rated TV episodes.
/account/{account_id}/rated/tv
This endpoint allows you to get a user’s list of rated TV shows.
/account/{account_id}/watchlist/movies
This endpoint allows you to get a list of movies added to a user’s watchlist.
/account/{account_id}/watchlist/tv
This endpoint allows you to get a list of TV shows added to a user’s watchlist.
Certifications
/certification/movie/list
This endpoint allows you to get an up-to-date list of the officially supported movie certifications on TMDB.
/certification/tv/list
This endpoint allows you to get an up-to-date list of the officially supported TV show certifications on TMDB.
Changes
/person/changes
This endpoint allows you to get an up-to-date list of the officially supported movie certifications on TMDB.
/tv/changes
This endpoint allows you to get an up-to-date list of the officially supported TV show certifications on TMDB.
Collections
/collection/{collection_id}
This endpoint allows you to fetch a collection by ID
/collection/{collection_id}/images
This endpoint allows you to fetch images that belong to a collection.
/collection/{collection_id}/translations
This endpoint allows you to fetch translations in a collection.
Authentication
Error codes & Rate limits
Assistant
Responses are generated using AI and may contain mistakes.