# TMDB API Documentation ## Docs - [Account ID](https://ileolami.mintlify.app/api-reference/account/account-id.md): This endpoint get user's account ID - [Add Favourite](https://ileolami.mintlify.app/api-reference/account/add-favourite.md): This endpoint allows the user to add a specific media item as a favorite. - [Add to Watchlist](https://ileolami.mintlify.app/api-reference/account/add-to-watchlist.md): This endpoint allows the user to add a movie or TV show to their watchlist. - [Details](https://ileolami.mintlify.app/api-reference/account/details.md): This endpoint get the public details of user's account. - [Favorite Movies](https://ileolami.mintlify.app/api-reference/account/favorite-movies.md): This endpoint get user's list of favorite movies. - [Favorite TV](https://ileolami.mintlify.app/api-reference/account/favorite-tv.md): This endpoint get user's list of favorite tv shows. - [Lists](https://ileolami.mintlify.app/api-reference/account/lists.md): This endpoint get the lists of user's added movies - [Rated Movie](https://ileolami.mintlify.app/api-reference/account/rated-movie.md): This endpoint get list of user's rated movies - [Rated Tv](https://ileolami.mintlify.app/api-reference/account/rated-tv.md): This endpoint get list of user's rated TV - [Rated Tv Episode](https://ileolami.mintlify.app/api-reference/account/rated-tv-episode.md): This endpoint get the list of user's list of rated tv episodes - [Watchlist Movies](https://ileolami.mintlify.app/api-reference/account/watchlist-movies.md): This endpoint get a list of movies added to a users watchlist. - [Watchlist TV](https://ileolami.mintlify.app/api-reference/account/watchlist-tv.md): This endpoint get a list of TV shows added to a users watchlist. - [Validate Your API Key](https://ileolami.mintlify.app/api-reference/authentication.md): This is an interactive playground to test your API key - [Create Guest Session](https://ileolami.mintlify.app/api-reference/authentication/create-guest-session.md): This endpoint create a new guest session. - [Create Request Token](https://ileolami.mintlify.app/api-reference/authentication/create-request-token.md): This endpoint obtain a new token from the authentication server. - [Create Session](https://ileolami.mintlify.app/api-reference/authentication/create-session.md): This endpoint is used to create a new session. - [Delete Session](https://ileolami.mintlify.app/api-reference/authentication/delete-session.md): This endpoint is used to delete a session id. - [Validate Key](https://ileolami.mintlify.app/api-reference/authentication/validate-key.md): This endpoint test your API Key to see if it's valid. - [Validate Request Token with login](https://ileolami.mintlify.app/api-reference/authentication/validate-request-token-with-login.md): This endpoint allow users to validate a request token by entering a username and password. - [Movies](https://ileolami.mintlify.app/api-reference/certification/movies.md): This endpoint get the list of movie certifications for different countries. - [TV](https://ileolami.mintlify.app/api-reference/certification/tv.md): This endpoint get the list of TV show certifications for different countries. - [Movies List](https://ileolami.mintlify.app/api-reference/changes/movies-list.md): This endpoint get a list of all of the movie ids that have been changed in the past 24 hours. - [People List](https://ileolami.mintlify.app/api-reference/changes/people-list.md): This endpoint get list of all of the people ids that have been changed in the past 24 hours. - [TV List](https://ileolami.mintlify.app/api-reference/changes/tv-list.md): This endpoint get list of all of the tv show ids that have been changed in the past 24 hours. - [Details](https://ileolami.mintlify.app/api-reference/collection/details.md): This endpoint get movies collection details by ID. - [Images](https://ileolami.mintlify.app/api-reference/collection/images.md): This endpoints get images that belong to a collection. - [Translations](https://ileolami.mintlify.app/api-reference/collection/translations.md): This endpoint get the translations for a specific collection. - [Alternative Names](https://ileolami.mintlify.app/api-reference/companies/alternative-names.md): This endpoint get company's alternative names - [Details](https://ileolami.mintlify.app/api-reference/companies/details.md): This endpoint get details of a specific company - [Images](https://ileolami.mintlify.app/api-reference/companies/images.md): This endpoint get company's logo - [Countries](https://ileolami.mintlify.app/api-reference/configuration/countries.md): This endpoint get the list of countries (ISO 3166-1 tags) used throughout TMDB. - [Details](https://ileolami.mintlify.app/api-reference/configuration/details.md): This endpoint get the API configuration details. - [Job](https://ileolami.mintlify.app/api-reference/configuration/job.md): This endpoint get the list of the jobs and departments we use on TMDB. - [Languages](https://ileolami.mintlify.app/api-reference/configuration/languages.md): This endpoint retrieves the list of languages (ISO 639-1 tags) used throughout TMDB. - [Primary Translation](https://ileolami.mintlify.app/api-reference/configuration/primary-translation.md): This endpoint get list of the officially supported translations on TMDB. - [Time Zones](https://ileolami.mintlify.app/api-reference/configuration/time-zones.md): This endpoint get the list of timezones used throughout TMDB.. - [Details](https://ileolami.mintlify.app/api-reference/credits/details.md): This endpoint get a movie or TV credit details. - [Movies](https://ileolami.mintlify.app/api-reference/discover/movies.md): This endpoint find movies using 30 filters and sort options. - [TV](https://ileolami.mintlify.app/api-reference/discover/tv.md): The endpoint find TV shows using over 30 filters and sort options. - [Find by ID](https://ileolami.mintlify.app/api-reference/find/find-by-id.md): This endpoint find data by external ID's. - [Movies](https://ileolami.mintlify.app/api-reference/genres/movies.md): This endpoint get the list of official genres for movies - [TV](https://ileolami.mintlify.app/api-reference/genres/tv.md): This endpoint get the list of official genres for TV shows - [Rated Movie](https://ileolami.mintlify.app/api-reference/guest-session/rated-movie.md): This endpoint get rated movies for a guest session. - [Rated TV](https://ileolami.mintlify.app/api-reference/guest-session/rated-tv.md): This endpoint get rated TV shows for a guest session. - [Rated TV Episodes](https://ileolami.mintlify.app/api-reference/guest-session/rated-tv-episodes.md): This endpoint get rated TV episodes for a guest session. - [Getting Started](https://ileolami.mintlify.app/api-reference/introduction.md) - [Details](https://ileolami.mintlify.app/api-reference/keywords/details.md): This endpoint get information about a specific keyword - [Movies](https://ileolami.mintlify.app/api-reference/keywords/movies.md): The endpoint get a list of movies associated with a keyword - [Add Movie](https://ileolami.mintlify.app/api-reference/lists/add-movie.md): This endpoint is used to add a movie to a list - [Check item Status](https://ileolami.mintlify.app/api-reference/lists/check-item-status.md): This endpoint check if an item has already been added to the list. - [Clear](https://ileolami.mintlify.app/api-reference/lists/clear.md): This endpoint clear all items from a list. - [Create](https://ileolami.mintlify.app/api-reference/lists/create.md): This endpoint is used add of movie detail to list. - [Delete](https://ileolami.mintlify.app/api-reference/lists/delete.md): This endpoint delete a list. - [Details](https://ileolami.mintlify.app/api-reference/lists/details.md): This endpoint get details of a specific list - [Remove Movie](https://ileolami.mintlify.app/api-reference/lists/remove-movie.md): This endpoint is used to remove a movie from a list. - [Now Playing](https://ileolami.mintlify.app/api-reference/movie-lists/now-playing.md): This endpoint get the list of movies that are currently in theatres in a country. - [Popular](https://ileolami.mintlify.app/api-reference/movie-lists/popular.md): This endpoint get the list of popular movies. - [Top Rated](https://ileolami.mintlify.app/api-reference/movie-lists/top-rated.md): This endpoint get the list of most rated movies. - [Upcoming](https://ileolami.mintlify.app/api-reference/movie-lists/upcoming.md): This endpoint get upcoming movies with a specific language, page, and region. - [Account States](https://ileolami.mintlify.app/api-reference/movies/account-states.md): This endpoint get the rating, watchlist and favourite status of an account. - [Add Rating](https://ileolami.mintlify.app/api-reference/movies/add-rating.md): This endpoint allow users to rate a movie and save it to their rated list. - [Alternative Title](https://ileolami.mintlify.app/api-reference/movies/alternative-title.md): This endpoint get alternative titles for a Movie - [Changes](https://ileolami.mintlify.app/api-reference/movies/changes.md): This endpoint get recent changes for a movie - [Credit](https://ileolami.mintlify.app/api-reference/movies/credit.md): This endpoint get the credits for a specific movie. - [Delete Rating](https://ileolami.mintlify.app/api-reference/movies/delete-rating.md): This endpoint delete a user rating - [Details](https://ileolami.mintlify.app/api-reference/movies/details.md): This endpoint get the top level details of a movie by ID. - [External IDs](https://ileolami.mintlify.app/api-reference/movies/external-ids.md): The endpoint get the external IDs associated with a specific movie. - [Images](https://ileolami.mintlify.app/api-reference/movies/images.md): The endpoint get images associated with a specific movie. - [Keywords](https://ileolami.mintlify.app/api-reference/movies/keywords.md): This endpoint get keywords associated with a specific movie - [Latest](https://ileolami.mintlify.app/api-reference/movies/latest.md): This endpoint get the details of the latest movie. - [Lists](https://ileolami.mintlify.app/api-reference/movies/lists.md): This endpoint get the lists that a movie has been added to. - [Recommendations](https://ileolami.mintlify.app/api-reference/movies/recommendations.md): This endpoint get a list of recommended movies for a specific movie, identified by its unique ID. - [Release Dates](https://ileolami.mintlify.app/api-reference/movies/release-dates.md): This endpoint get the release date and certification of a movie. - [Reviews](https://ileolami.mintlify.app/api-reference/movies/reviews.md): This endpoint get reviews of a movie - [Similar](https://ileolami.mintlify.app/api-reference/movies/similar.md): This endpoint get the similar movies based on genres and keywords. - [Translations](https://ileolami.mintlify.app/api-reference/movies/translations.md): This enpoint get the translations for a movie. - [Videos](https://ileolami.mintlify.app/api-reference/movies/videos.md): This endpoint get videos of a movie - [Watch Providers](https://ileolami.mintlify.app/api-reference/movies/watch-providers.md): This endpoint get the list of streaming providers for a movie. - [Alternative names](https://ileolami.mintlify.app/api-reference/network/alternative-names.md): This endpoint get the alternative names of a specifc network. - [Details](https://ileolami.mintlify.app/api-reference/network/details.md): This endpoint get details for a specific network based on the provided network ID. - [Images](https://ileolami.mintlify.app/api-reference/network/images.md): This endpoint get the logo of a network. - [Popular](https://ileolami.mintlify.app/api-reference/people-lists/popular.md): This endpoint get list of popular people. - [Changes](https://ileolami.mintlify.app/api-reference/people/changes.md): This endpoint get the recent changes for a person - [Combine Credit](https://ileolami.mintlify.app/api-reference/people/combine-credit.md): This endpoint get the combined movie and TV credits that belong to a person. - [Details](https://ileolami.mintlify.app/api-reference/people/details.md): This endpoint get the details of a person - [External IDs](https://ileolami.mintlify.app/api-reference/people/external-ids.md): This endpoint get the external ID's that belong to a person. - [Images](https://ileolami.mintlify.app/api-reference/people/images.md): This endpoint get the profile images that belong to a person. - [Latest](https://ileolami.mintlify.app/api-reference/people/latest.md): This endpoint get the latest person in the industry. This is a live response and will continuously change. - [Movie Credit](https://ileolami.mintlify.app/api-reference/people/movie-credit.md): This endpoint get the movie credits of a person - [Tagged Images](https://ileolami.mintlify.app/api-reference/people/tagged-images.md): This endpoint get the tagged images for a person. - [Translations](https://ileolami.mintlify.app/api-reference/people/translations.md): This endpoint get the translations that belong to a person. - [TV Credit](https://ileolami.mintlify.app/api-reference/people/tv-credit.md): This endpoint get the TV show credits that belong to a person. - [Details](https://ileolami.mintlify.app/api-reference/reviews/details.md): This endpoint get the details of a movie or TV show review. - [Collection](https://ileolami.mintlify.app/api-reference/search/collection.md): This endpoint search for collections by their original, translated and alternative names. - [Company](https://ileolami.mintlify.app/api-reference/search/company.md): This endpoint search companies by their original and alternative names. - [Keywords](https://ileolami.mintlify.app/api-reference/search/keywords.md): This endpoint search for keywords by their name. - [Movies](https://ileolami.mintlify.app/api-reference/search/movies.md): This endpoint serach for movies by their original, translated and alternative titles. - [Multi](https://ileolami.mintlify.app/api-reference/search/multi.md): This endpoint multi search for movies, TV shows and people in a single request. - [Person](https://ileolami.mintlify.app/api-reference/search/person.md): This endpoint search for people in a based on type of movies or tv shows. - [TV](https://ileolami.mintlify.app/api-reference/search/tv.md): This endpoint search for TV shows by their original, translated and also known as names. - [All](https://ileolami.mintlify.app/api-reference/trending/all.md): This endpoint get all trending movies, TV shows and people. - [Movie](https://ileolami.mintlify.app/api-reference/trending/movie.md): This endpoint get the list of trending movies. - [People](https://ileolami.mintlify.app/api-reference/trending/people.md): This endpoint get the list of trending people. - [TV](https://ileolami.mintlify.app/api-reference/trending/tv.md): This endpoint get the trending TV shows. - [Details](https://ileolami.mintlify.app/api-reference/tv-episodes-groups/details.md): This endpoint get the details of a TV episode group. - [Account States](https://ileolami.mintlify.app/api-reference/tv-episodes/account-states.md): This endpoint get the rating, watchlist and favourite status of a TV episode. - [Add rating](https://ileolami.mintlify.app/api-reference/tv-episodes/add-rating.md): This endpoint allow user to rate a TV episode. - [Changes](https://ileolami.mintlify.app/api-reference/tv-episodes/changes.md): This endpoint get the recent changes of a TV episode. - [Credits](https://ileolami.mintlify.app/api-reference/tv-episodes/credits.md): This endpoint get the credits for an episode. - [Delete Rating](https://ileolami.mintlify.app/api-reference/tv-episodes/delete-rating.md): This endpoint allows users to delete their rating from a TV episode. - [Details](https://ileolami.mintlify.app/api-reference/tv-episodes/details.md): This endpoint get the details of a TV episode. - [External IDs](https://ileolami.mintlify.app/api-reference/tv-episodes/external-ids.md): This endpoint get a list of external IDs of a TV episode. - [Images](https://ileolami.mintlify.app/api-reference/tv-episodes/images.md): This endpoint get the images of a TV episode. - [Translations](https://ileolami.mintlify.app/api-reference/tv-episodes/translations.md): This endpoint get the translations of a TV episode. - [Videos](https://ileolami.mintlify.app/api-reference/tv-episodes/videos.md): This endpoint get the videos of a TV episode. - [Account States](https://ileolami.mintlify.app/api-reference/tv-seasons/account-states.md): This endpoint get the rating, watchlist and favourite status of a TV season - [Aggregate Credit](https://ileolami.mintlify.app/api-reference/tv-seasons/aggregate-credit.md): This endpoint get the aggregate credits (cast and crew) of a TV season. - [Changes](https://ileolami.mintlify.app/api-reference/tv-seasons/changes.md): This endpoint get the recent changes for a TV season. - [Credits](https://ileolami.mintlify.app/api-reference/tv-seasons/credits.md): This endpoint get the credits for a specific season of a TV series. - [Details](https://ileolami.mintlify.app/api-reference/tv-seasons/details.md): This endpoint get the details of a TV season. - [External IDs](https://ileolami.mintlify.app/api-reference/tv-seasons/external-ids.md): This endpoint get a list of external IDs of a TV season. - [Images](https://ileolami.mintlify.app/api-reference/tv-seasons/images.md): This endpoint get the images of a TV season. - [Translations](https://ileolami.mintlify.app/api-reference/tv-seasons/translations.md): This endpoint get the translations for a TV season. - [Videos](https://ileolami.mintlify.app/api-reference/tv-seasons/videos.md): This endpoint the videos of a TV season. - [Watch Providers](https://ileolami.mintlify.app/api-reference/tv-seasons/watch-providers.md): This endpoint get the list of streaming providers available for a TV season. - [Airing Today](https://ileolami.mintlify.app/api-reference/tv-series-list/airing-today.md): This endpoint get list of TV shows airing today. - [On The Air](https://ileolami.mintlify.app/api-reference/tv-series-list/on-the-air.md): The endpoint get list of TV shows that air in the next 7 days. - [Popular](https://ileolami.mintlify.app/api-reference/tv-series-list/popular.md): This endpoint get list of popular TV shows. - [Top Rated](https://ileolami.mintlify.app/api-reference/tv-series-list/top-rated.md): This endpoint get list of most rated TV show - [Account states](https://ileolami.mintlify.app/api-reference/tv-series/account-states.md): This endpoint get the rating, watchlist and favourite status. - [Add Ratings](https://ileolami.mintlify.app/api-reference/tv-series/add-ratings.md): This endpoint allow user to rate a TV show and automatically save it to their rated list. - [Aggregate Credit](https://ileolami.mintlify.app/api-reference/tv-series/aggregate-credit.md): This endpoint get the aggregate credits (cast and crew) added to a TV show. - [Alternative Titles](https://ileolami.mintlify.app/api-reference/tv-series/alternative-titles.md): This endpoint get the alternative titles of a TV show. - [Changes](https://ileolami.mintlify.app/api-reference/tv-series/changes.md): This endpoint get the recent changes for a TV show. - [Content Ratings](https://ileolami.mintlify.app/api-reference/tv-series/content-ratings.md): This endpoint get the content ratings of a TV show. - [Credits](https://ileolami.mintlify.app/api-reference/tv-series/credits.md): This endpoint get the latest season credits of a TV show. - [Delete Rating](https://ileolami.mintlify.app/api-reference/tv-series/delete-rating.md): This endpoint delete user's rating from a TV show. - [Details](https://ileolami.mintlify.app/api-reference/tv-series/details.md): This endpoint get the details of a TV show. - [Episode Groups](https://ileolami.mintlify.app/api-reference/tv-series/episode-groups.md): This endpoint get the episode groups of a TV show. - [External IDs](https://ileolami.mintlify.app/api-reference/tv-series/external-ids.md): This endpoint get a list of external IDs added to a TV show. - [Images](https://ileolami.mintlify.app/api-reference/tv-series/images.md): This endpoint get the images that belong to a TV series. - [Keywords](https://ileolami.mintlify.app/api-reference/tv-series/keywords.md): This endpoint get a list of keywords of a TV show. - [Latest](https://ileolami.mintlify.app/api-reference/tv-series/latest.md): This endpoint get the latest TV shows. - [Lists](https://ileolami.mintlify.app/api-reference/tv-series/lists.md): This endpoint get the list a TV series is added to. - [Recommendations](https://ileolami.mintlify.app/api-reference/tv-series/recommendations.md): This endpoint get recommendation for a specific TV series - [Reviews](https://ileolami.mintlify.app/api-reference/tv-series/reviews.md): This endpoint get the reviews of TV show. - [Screened Theatrically](https://ileolami.mintlify.app/api-reference/tv-series/screened-theatrically.md): This endpoint get the seasons and episodes that have screened theatrically. - [Similar](https://ileolami.mintlify.app/api-reference/tv-series/similar.md): This endpoint get similiar TV show to a TV show. - [Translations](https://ileolami.mintlify.app/api-reference/tv-series/translations.md): This endpoint get the translations of a TV show. - [Videos](https://ileolami.mintlify.app/api-reference/tv-series/videos.md): This endpoint get videos of a TV show. - [Watch providers](https://ileolami.mintlify.app/api-reference/tv-series/watch-providers.md): This endpoint get the list of streaming providers for a TV show. - [Available Regions](https://ileolami.mintlify.app/api-reference/watch-providers/available-regions.md): This endpoint get the list of the countries we have watch provider (OTT/streaming) data for. - [Movie Providers](https://ileolami.mintlify.app/api-reference/watch-providers/movie-providers.md): This endpoint get the list of streaming providers we have for movies. - [TV Providers](https://ileolami.mintlify.app/api-reference/watch-providers/tv-providers.md): This endpoint get the list of streaming providers we have for TV shows. - [Changelog](https://ileolami.mintlify.app/changelog/changlelog.md) - [Append To Response](https://ileolami.mintlify.app/parameters/append-response.md) - [Image URL](https://ileolami.mintlify.app/parameters/basic.md): How to build an image URL - [Daily ID Exports](https://ileolami.mintlify.app/parameters/daily-id.md): Download a list of valid IDs from TMDB. - [Finding Data](https://ileolami.mintlify.app/parameters/finding-id.md): How do you find data on TMDB? - [Guest Session](https://ileolami.mintlify.app/parameters/guest-session.md) - [Include Image Language](https://ileolami.mintlify.app/parameters/image_languages.md): How do languages work with image queries? - [Languages](https://ileolami.mintlify.app/parameters/languages.md): Learn about supported languages on TMDB. - [Regions](https://ileolami.mintlify.app/parameters/region-support.md): How does region support work on TMDB? - [Search & Query For Details](https://ileolami.mintlify.app/parameters/search.md): Learn how to search and query for a movie. - [Session ID](https://ileolami.mintlify.app/parameters/session-id.md) - [User Authentication](https://ileolami.mintlify.app/parameters/user.md): Need to make a user based call? - [Application Level Authentication](https://ileolami.mintlify.app/the-basics/application.md): The Default Way to Authenticate - [FAQ](https://ileolami.mintlify.app/the-basics/faq.md) - [Overview](https://ileolami.mintlify.app/the-basics/introduction.md) - [JSON & JSONP](https://ileolami.mintlify.app/the-basics/json.md) - [Popularity and Trending](https://ileolami.mintlify.app/the-basics/pop-trending.md) - [Quickstart](https://ileolami.mintlify.app/the-basics/quickstart.md): Learn how to get your API Key and Session ID - [Roadmap](https://ileolami.mintlify.app/the-basics/roadmap.md): What are we working on? - [Status Codes & Rate Limiting](https://ileolami.mintlify.app/the-basics/status-codes.md): This is a list of status codes used by TMDB. - [Versioning](https://ileolami.mintlify.app/the-basics/versoning.md) - [Wrappers and Libraries](https://ileolami.mintlify.app/the-basics/wrapper-libraries.md): A list of community-built wrappers and libraries for various programming languages to interact with the TMDB API. ## OpenAPI Specs - [version4](https://ileolami.mintlify.app/version-4/api-reference-4/version4.yaml) - [openapi](https://ileolami.mintlify.app/api-reference/openapi.yaml) - [check](https://ileolami.mintlify.app/check.yaml) - [movie](https://ileolami.mintlify.app/api-reference/movie.yaml)