Skip to main content

​
Base url

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.