Skip to main content

TMDB-API-Docs home page

Service Status
Support
Login
Login

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

Certifications

List movie certifications

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

List watchlisted TV shows List TV certifications

x github linkedin