# TMDb API Documentation ## Docs - [API Key](https://tvc.mintlify.app/api-key.md): Get started with the TMDb API in just a few steps. - [Add Favorite](https://tvc.mintlify.app/api-reference/endpoint/account/add-favorite.md): This endpoint marks a movie or TV show as a favourite. - [Add to Watchlist](https://tvc.mintlify.app/api-reference/endpoint/account/add-to-watchlist.md): This endpoint adds a movie or TV show to your watchlist. - [Favorite Movies](https://tvc.mintlify.app/api-reference/endpoint/account/favorite-movies.md): This endpoint gets a users list of favourite movies. - [Favorite TV](https://tvc.mintlify.app/api-reference/endpoint/account/favorite-tv.md): This endpoint gets a users list of favourite TV shows. - [Get Details](https://tvc.mintlify.app/api-reference/endpoint/account/get-details.md): This endpoint gets the public details of an account on TMDB. - [Lists](https://tvc.mintlify.app/api-reference/endpoint/account/lists.md): This endpoint gets a users list of custom lists. - [Rated Movies](https://tvc.mintlify.app/api-reference/endpoint/account/rated-movies.md): This endpoint gets a users list of rated movies. - [Rated TV](https://tvc.mintlify.app/api-reference/endpoint/account/rated-tv.md): This endpoint gets a users list of rated TV shows. - [Rated TV Episodes](https://tvc.mintlify.app/api-reference/endpoint/account/rated-tv-episodes.md): This endpoint gets a users list of rated TV episodes. - [Watchlist Movies](https://tvc.mintlify.app/api-reference/endpoint/account/watchlist-movies.md): This endpoint gets a list of movies added to a users watchlist. - [Watchlist TV](https://tvc.mintlify.app/api-reference/endpoint/account/watchlist-tv.md): This endpoint gets a list of TV shows added to a users watchlist. - [Create a Session (from v4 Token)](https://tvc.mintlify.app/api-reference/endpoint/authentication/create-a-session-from-v4-token.md): Create a Session (from v4 Token) - [Create Guest Session](https://tvc.mintlify.app/api-reference/endpoint/authentication/create-guest-session.md): This endpoint grants you a temporary "guest session" on TMDb, allowing limited access to features like rating movies and TV shows without needing a full user account. - [Create User Session](https://tvc.mintlify.app/api-reference/endpoint/authentication/create-user-session.md): This endpoint creates a session ID for the user after validating the request token. - [Delete Session](https://tvc.mintlify.app/api-reference/endpoint/authentication/delete-session.md): Delete Session - [Request Token](https://tvc.mintlify.app/api-reference/endpoint/authentication/request-token.md): This endpoint gets a temporary "request token" from TMDb. This is your first step to allow your application to access a user's account data (like ratings or watchlists) with their permission. - [Request Token with Login](https://tvc.mintlify.app/api-reference/endpoint/authentication/request-token-with-login.md): This endpoint validates the request token with the user's credentials such as Username, Password and Request Token. - [Validate API Key](https://tvc.mintlify.app/api-reference/endpoint/authentication/validate-api-key.md): Validate API Key - [Movie Certifications](https://tvc.mintlify.app/api-reference/endpoint/certifications/movie-certifications.md): This endpoint gets an up to date list of the officially supported movie certifications on TMDB. - [TV Certification](https://tvc.mintlify.app/api-reference/endpoint/certifications/tv-certification.md): This endpoint retrieves a list of all the TV content rating systems (certifications) available on TMDb. - [Movie List](https://tvc.mintlify.app/api-reference/endpoint/changes/movie-list.md): This endpoint gets a list of all of the movie ids that have been changed in the past 24 hours. - [People List](https://tvc.mintlify.app/api-reference/endpoint/changes/people-list.md): This endpoint gets people list - [TV LIst](https://tvc.mintlify.app/api-reference/endpoint/changes/tv-list.md): This endpoint gets TV list - [Details](https://tvc.mintlify.app/api-reference/endpoint/collections/details.md): This endpoint gets collection details by ID. - [Images](https://tvc.mintlify.app/api-reference/endpoint/collections/images.md): This endpoint gets the images that belong to a collection. - [Translations](https://tvc.mintlify.app/api-reference/endpoint/collections/translations.md): This endpoint translates - [Alternative Names](https://tvc.mintlify.app/api-reference/endpoint/companies/alternative-names.md): This endpoint gets the company details by ID. - [Details](https://tvc.mintlify.app/api-reference/endpoint/companies/details.md): This endpoint gets the company details by ID. - [Images](https://tvc.mintlify.app/api-reference/endpoint/companies/images.md): This endpoint gets the company logos by id. - [Countries](https://tvc.mintlify.app/api-reference/endpoint/configuration/countries.md): This endpoint gets the list of countries (ISO 3166-1 tags) used throughout TMDB. - [Details](https://tvc.mintlify.app/api-reference/endpoint/configuration/details.md): This endpoint queries the API configuration details. - [Jobs](https://tvc.mintlify.app/api-reference/endpoint/configuration/jobs.md): This endpoint gets the list of the jobs and departments we use on TMDB. - [Languages](https://tvc.mintlify.app/api-reference/endpoint/configuration/languages.md): This endpoint gets the list of languages (ISO 639-1 tags) used throughout TMDB. - [Primary Translations](https://tvc.mintlify.app/api-reference/endpoint/configuration/primary-translations.md): This endpoint gets a list of the officially supported translations on TMDB. - [Time Zones](https://tvc.mintlify.app/api-reference/endpoint/configuration/time-zones.md): This endpoint gets the list of timezones used throughout TMDB. - [Credits](https://tvc.mintlify.app/api-reference/endpoint/credits/credits.md): This endpoint gets a movie or TV credit details by ID. - [Movie](https://tvc.mintlify.app/api-reference/endpoint/discover/movie.md): This endpoint finds movies using over 30 filters and sort options. - [TV](https://tvc.mintlify.app/api-reference/endpoint/discover/tv.md): This endpoint finds TV shows using over 30 filters and sort options. - [Find By ID](https://tvc.mintlify.app/api-reference/endpoint/find/find-by-id.md): This endpoint finds data by external ID's. - [Movie List](https://tvc.mintlify.app/api-reference/endpoint/genres/movie-list.md): This endpoint gets the list of official genres for movies. - [TV List](https://tvc.mintlify.app/api-reference/endpoint/genres/tv-list.md): This endpoint gets the list of official genres for TV shows. - [Rated Movies](https://tvc.mintlify.app/api-reference/endpoint/guest-sessions/rated-movies.md): This endpoint gets the rated movies for a guest session. - [Details](https://tvc.mintlify.app/api-reference/endpoint/keywords/details.md): This endpoint retrieves details about a specific keyword from the TMDb database using its ID. - [Movies](https://tvc.mintlify.app/api-reference/endpoint/keywords/movies.md): This endpoint is deprecated, you should use [/discover/movie](https://developer.themoviedb.org/reference/discover-movie) instead. - [Add Movie](https://tvc.mintlify.app/api-reference/endpoint/lists/add-movie.md): This endpoint adds a movie to a list. - [Check Item Status](https://tvc.mintlify.app/api-reference/endpoint/lists/check-item-status.md): This endpoint checks if an item has already been added to the list. - [Clear](https://tvc.mintlify.app/api-reference/endpoint/lists/clear.md): This endpoint clears all items from a list. - [Create](https://tvc.mintlify.app/api-reference/endpoint/lists/create.md): This enpoint adds a movie to the list. - [Details](https://tvc.mintlify.app/api-reference/endpoint/lists/details.md): This endpoint deletes a movie from the list. - [Now Playing](https://tvc.mintlify.app/api-reference/endpoint/movie-list/now-playing.md): This endpoint gets a list of movies that are currently in theatres. - [Popular](https://tvc.mintlify.app/api-reference/endpoint/movie-list/popular.md): This endpoint gets a list of movies ordered by popularity. - [Top Rated](https://tvc.mintlify.app/api-reference/endpoint/movie-list/top-rated.md): This endpoint gets a list of movies ordered by rating. - [Upcoming](https://tvc.mintlify.app/api-reference/endpoint/movie-list/upcoming.md): This endpoint gets a list of movies that are being released soon. - [Account States](https://tvc.mintlify.app/api-reference/endpoint/movies/account-states.md): This endpoint gets the rating, watchlist and favourite status of an account. - [Add Rating](https://tvc.mintlify.app/api-reference/endpoint/movies/add-rating.md): This endpoint rates a movie and save it to your rated list. - [Alternative Titles](https://tvc.mintlify.app/api-reference/endpoint/movies/alternative-titles.md): This endpoint gets the alternative titles for a movie. - [Changes](https://tvc.mintlify.app/api-reference/endpoint/movies/changes.md): This endpoint gets the recent changes for a movie. - [Credits](https://tvc.mintlify.app/api-reference/endpoint/movies/credits.md): This endpoint retrieves the cast and crew information (credits) for a specific movie, identified by its `{movie_id}`, from the TMDb database. - [Delete Rating](https://tvc.mintlify.app/api-reference/endpoint/movies/delete-rating.md): This endpoint deletes a user rating. - [External IDs](https://tvc.mintlify.app/api-reference/endpoint/movies/external-ids.md): This endpoint gives IDs of a movie on supported social media platforms like Facebook, Twitter, Instagram, IMDb, and Wikidata. - [Get Details](https://tvc.mintlify.app/api-reference/endpoint/movies/get-details.md): This endpoint gets the top level details of a movie by ID. - [Images](https://tvc.mintlify.app/api-reference/endpoint/movies/images.md): This endpoint gets the images that belong to a movie. - [Keywords](https://tvc.mintlify.app/api-reference/endpoint/movies/keywords.md): This endpoint fetches IDs and Keywords of Movies. - [Latest](https://tvc.mintlify.app/api-reference/endpoint/movies/latest.md): This endpoint gets the newest movie ID. - [Lists](https://tvc.mintlify.app/api-reference/endpoint/movies/lists.md): This endpoint gets the lists that a movie has been added to. - [Recommendations](https://tvc.mintlify.app/api-reference/endpoint/movies/recommendations.md): this endpoint gives recommendations for movies. - [Release Dates](https://tvc.mintlify.app/api-reference/endpoint/movies/release-dates.md): This endpoint gets the release dates and certifications for a movie. - [Reviews](https://tvc.mintlify.app/api-reference/endpoint/movies/reviews.md): This endpoint gets user reviews for a movie. - [Similar](https://tvc.mintlify.app/api-reference/endpoint/movies/similar.md): This endpoint gets similar movies based on genres and keywords - [Translations](https://tvc.mintlify.app/api-reference/endpoint/movies/translations.md): This endpoint gets translation for a movie. - [Videos](https://tvc.mintlify.app/api-reference/endpoint/movies/videos.md): This endpoint fetches video clips of a movie. - [Watch Providers](https://tvc.mintlify.app/api-reference/endpoint/movies/watch-providers.md): This endpoint gets the list of streaming providers we have for a movie. - [Alternative Names](https://tvc.mintlify.app/api-reference/endpoint/networks/alternative-names.md): This endpoint gets the alternative names of a network. - [Details](https://tvc.mintlify.app/api-reference/endpoint/networks/details.md): This endpoint lets you get all the details about a specific TV network identified by its `network_id` on TMDb, like its name, headquarters, and logo. - [Images](https://tvc.mintlify.app/api-reference/endpoint/networks/images.md): This endpoint gets the TV network logos by id. - [Popular](https://tvc.mintlify.app/api-reference/endpoint/people-lists/popular.md): This enpoint gets a list of people ordered by popularity. - [Changes](https://tvc.mintlify.app/api-reference/endpoint/people/changes.md): This endpoint gets the recent changes for a person. - [Combined Credits](https://tvc.mintlify.app/api-reference/endpoint/people/combined-credits.md): This endpoint gets the combined movie and TV credits that belong to a person. - [Details](https://tvc.mintlify.app/api-reference/endpoint/people/details.md): This endpoint queries the top level details of a person. - [External IDs](https://tvc.mintlify.app/api-reference/endpoint/people/external-ids.md): This endpoint gets the external ID's that belong to a person. - [Images](https://tvc.mintlify.app/api-reference/endpoint/people/images.md): This endpoint gets the profile images that belong to a person. - [Latest](https://tvc.mintlify.app/api-reference/endpoint/people/latest.md): This endpoint gets the newest created person. This is a live response and will continuously change. - [Movie Credits](https://tvc.mintlify.app/api-reference/endpoint/people/movie-credits.md): Get the movie credits for a person. - [Tagged Images](https://tvc.mintlify.app/api-reference/endpoint/people/tagged-images.md): Get the tagged images for a person. - [Translations](https://tvc.mintlify.app/api-reference/endpoint/people/translations.md): This endpoint gets the translations that belong to a person. - [TV Credits](https://tvc.mintlify.app/api-reference/endpoint/people/tv-credits.md): This endpoint gets the TV credits that belong to a person. - [Details](https://tvc.mintlify.app/api-reference/endpoint/reviews/details.md): This endpoint retrieves the details of a movie or TV show review. - [Collections](https://tvc.mintlify.app/api-reference/endpoint/search/collections.md): Collections - [Company](https://tvc.mintlify.app/api-reference/endpoint/search/company.md): This endpoint searches for companies by their original and alternative names. - [Keyword](https://tvc.mintlify.app/api-reference/endpoint/search/keyword.md): This endpoint searches for keywords by their name. - [Movie](https://tvc.mintlify.app/api-reference/endpoint/search/movie.md): This endpoin searches for movies by their original, translated and alternative titles. - [Multi](https://tvc.mintlify.app/api-reference/endpoint/search/multi.md): This endpoint uses multi search when you want to search for movies, TV shows and people in a single request. - [Person](https://tvc.mintlify.app/api-reference/endpoint/search/person.md): This endpoint searches for people by their name and also known as names. - [TV Shows](https://tvc.mintlify.app/api-reference/endpoint/search/tv-shows.md): This endpoint searches for TV shows by their original, translated and also known as names. - [All](https://tvc.mintlify.app/api-reference/endpoint/trending/all.md): All - [Movies](https://tvc.mintlify.app/api-reference/endpoint/trending/movies.md): This endpoint gets the trending movies on TMDB. - [People](https://tvc.mintlify.app/api-reference/endpoint/trending/people.md): This endpoint gets the trending people on TMDB. - [TV](https://tvc.mintlify.app/api-reference/endpoint/trending/tv.md): This endpoint gets the trending TV shows on TMDB. - [Details](https://tvc.mintlify.app/api-reference/endpoint/tv-episode-groups/details.md): This endpoint gets the list of the countries we have watch provider (OTT/streaming) data for. - [Account States](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/account-states.md): This endpoint gets the rating, watchlist and favourite status. - [Add Rating](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/add-rating.md): This endpoint allows you to rate a TV episode and save it to your rated list. - [Changes](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/changes.md): This endpoint gets the recent changes for a TV episode. - [Credits](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/credits.md): This endpoint retrieves the cast and crew information for a specific episode of a TV show. - [Delete Rating](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/delete-rating.md): This endpoint deletes your rating on a TV episode. - [Details](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/details.md): This endpoint queries the details of a TV episode. - [External IDs](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/external-ids.md): This endpoint gets a list of external IDs that have been added to a TV episode. - [Images](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/images.md): This endpoint gets the images that belong to a TV episode. - [Translations](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/translations.md): This endpoint gets the translations that have been added to a TV episode. - [Videos](https://tvc.mintlify.app/api-reference/endpoint/tv-episodes/videos.md): This endpoint gets the videos that belong to a TV episode. - [Account States](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/account-states.md): This endpoint gets the rating, watchlist and favourite status. - [Aggregate Credits](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/aggregate-credits.md): This endpoint gets the aggregate credits (cast and crew) that have been added to a TV season. - [Changes](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/changes.md): This endpoint gets the recent changes for a TV season. - [Credits](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/credits.md): This endpoint retrieves the cast and crew information (credits) for all the episodes within a specific season of a TV show. - [Details](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/details.md): This endpoint queries the details of a TV season. - [External IDs](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/external-ids.md): This endpoint gets a list of external IDs that have been added to a TV season. - [Images](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/images.md): This endpoint gets the images that belong to a TV season. - [Translations](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/translations.md): This endpoint gets the translations for a TV season. - [Videos](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/videos.md): This endpoint gets the videos that belong to a TV season. - [Watch Providers](https://tvc.mintlify.app/api-reference/endpoint/tv-seasons/watch-providers.md): This endpoint gets the list of streaming providers we have for a TV season. - [Airing Today](https://tvc.mintlify.app/api-reference/endpoint/tv-series-lists/airing-today.md): This endpoint gets a list of TV shows airing today. - [On The Air](https://tvc.mintlify.app/api-reference/endpoint/tv-series-lists/on-the-air.md): This endpoint gets a list of TV shows that air in the next 7 days. - [Popular](https://tvc.mintlify.app/api-reference/endpoint/tv-series-lists/popular.md): This endpoint gets a list of TV shows ordered by popularity. - [Top Rated](https://tvc.mintlify.app/api-reference/endpoint/tv-series-lists/top-rated.md): This endpoint gets a list of TV shows ordered by rating. - [Account States](https://tvc.mintlify.app/api-reference/endpoint/tv-series/account-states.md): Account States - [Add Rating](https://tvc.mintlify.app/api-reference/endpoint/tv-series/add-rating.md): This endpoint rates a TV show and save it to your rated list. - [Aggregate Credits](https://tvc.mintlify.app/api-reference/endpoint/tv-series/aggregate-credits.md): This endpoint gets the aggregate credits (cast and crew) that have been added to a TV show. - [Alternative Titles](https://tvc.mintlify.app/api-reference/endpoint/tv-series/alternative-titles.md): This endpoint gets the alternative titles that have been added to a TV show. - [Changes](https://tvc.mintlify.app/api-reference/endpoint/tv-series/changes.md): This endpoint gets the recent changes for a TV show. - [Content Ratings](https://tvc.mintlify.app/api-reference/endpoint/tv-series/content-ratings.md): This endpoint gets the content ratings that have been added to a TV show. - [Delete Rating](https://tvc.mintlify.app/api-reference/endpoint/tv-series/delete-rating.md): This endpoint deletes user ratings for TV series. - [Details](https://tvc.mintlify.app/api-reference/endpoint/tv-series/details.md): This endpoint gets the details of a TV show. - [Episode Groups](https://tvc.mintlify.app/api-reference/endpoint/tv-series/episode-groups.md): This endpoint gets the episode groups that have been added to a TV show. - [External IDs](https://tvc.mintlify.app/api-reference/endpoint/tv-series/external-ids.md): This endpoint gets a list of external IDs that have been added to a TV show. - [Images](https://tvc.mintlify.app/api-reference/endpoint/tv-series/images.md): This endpoint gets the images that belong to a TV series. - [Keywords](https://tvc.mintlify.app/api-reference/endpoint/tv-series/keywords.md): This endpoint gets a list of keywords that have been added to a TV show. - [Latest](https://tvc.mintlify.app/api-reference/endpoint/tv-series/latest.md): This endpoint gets the newest TV show ID. - [Lists](https://tvc.mintlify.app/api-reference/endpoint/tv-series/lists.md): This endpoint gets the lists that a TV series has been added to. - [Recommendations](https://tvc.mintlify.app/api-reference/endpoint/tv-series/recommendations.md): This endpoint recommends TV shows similar to the one specified by its `series_id`, allowing you to discover new shows based on your interests. - [Reviews](https://tvc.mintlify.app/api-reference/endpoint/tv-series/reviews.md): This endpoint gets the reviews that have been added to a TV show. - [Screened Theatrically](https://tvc.mintlify.app/api-reference/endpoint/tv-series/screened-theatrically.md): This endpoint gets the seasons and episodes that have screened theatrically. - [Similar](https://tvc.mintlify.app/api-reference/endpoint/tv-series/similar.md): This endpoint gets the seasons and episodes that have screened theatrically. - [Translations](https://tvc.mintlify.app/api-reference/endpoint/tv-series/translations.md): This endpoint gets the translations that have been added to a TV show. - [Videos](https://tvc.mintlify.app/api-reference/endpoint/tv-series/videos.md): This endpoint gets the videos that belong to a TV show. - [Watch Providers](https://tvc.mintlify.app/api-reference/endpoint/tv-series/watch-providers.md): This endpoint gets the list of streaming providers we have for a TV show. - [Available Regions](https://tvc.mintlify.app/api-reference/endpoint/watch-providers/available-regions.md): This endpoint gets the list of the countries we have watch provider (OTT/streaming) data for. - [Movie Providers](https://tvc.mintlify.app/api-reference/endpoint/watch-providers/movie-providers.md): This endpoint gets the list of streaming providers we have for movies. - [TV Providers](https://tvc.mintlify.app/api-reference/endpoint/watch-providers/tv-providers.md): This endpoint gets the list of streaming providers we have for TV shows. - [Finding IDs](https://tvc.mintlify.app/find-ids.md) - [Getting Started](https://tvc.mintlify.app/getting-started.md): Welcome to the TMDb API documentation - [Glossary](https://tvc.mintlify.app/glossary.md) - [Possible Errors](https://tvc.mintlify.app/possible-errors.md) - [Rate Limiting](https://tvc.mintlify.app/rate-limit.md) ## OpenAPI Specs - [openapi](https://tvc.mintlify.app/api-reference/openapi.yaml) ## Optional - [Community Forum](https://www.themoviedb.org/talk) - [API Status](https://status.themoviedb.org/)