TMDb
TMDb endpoints from Themoviedb
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
TMDb endpoints from Themoviedb
Endpoints 152
- GETValidate Key
/3/authenticationTest your API Key to see if it's valid. - GETDetails
/3/account/:account_idGet the public details of an account on TMDB. - POSTAdd Favorite
/3/account/:account_id/favoriteMark a movie or TV show as a favourite. - POSTAdd To Watchlist
/3/account/:account_id/watchlistAdd a movie or TV show to your watchlist. - GETFavorite Movies
/3/account/:account_id/favorite/moviesGet a users list of favourite movies. - GETFavorite TV
/3/account/:account_id/favorite/tvGet a users list of favourite TV shows. - GETLists
/3/account/:account_id/listsGet a users list of custom lists. - GETRated Movies
/3/account/:account_id/rated/moviesGet a users list of rated movies. - GETRated TV
/3/account/:account_id/rated/tvGet a users list of rated TV shows. - GETRated TV Episodes
/3/account/:account_id/rated/tv/episodesGet a users list of rated TV episodes. - GETWatchlist Movies
/3/account/:account_id/watchlist/moviesGet a list of movies added to a users watchlist. - GETWatchlist TV
/3/account/:account_id/watchlist/tvGet a list of TV shows added to a users watchlist. - GETCreate Guest Session
/3/authentication/guest_session/new - GETCreate Request Token
/3/authentication/token/new - POSTCreate Session
/3/authentication/session/new - POSTCreate Session (from v4 token)
/3/authentication/session/convert/4 - POSTCreate Session (with login)
/3/authentication/token/validate_with_loginThis method allows an application to validate a request token by entering a username and password. - DELETEDelete Session
/3/authentication/session - GETMovie Certifications
/3/certification/movie/listGet an up to date list of the officially supported movie certifications on TMDB. - GETTV Certifications
/3/certification/tv/list - GETMovie List
/3/movie/changesGet a list of all of the movie ids that have been changed in the past 24 hours. - GETPeople List
/3/person/changes - GETTV List
/3/tv/changes - GETDetails
/3/collection/:collection_idGet collection details by ID. - GETImages
/3/collection/:collection_id/imagesGet the images that belong to a collection. - GETTranslations
/3/collection/:collection_id/translations - GETDetails
/3/company/:company_idGet the company details by ID. - GETAlternative Names
/3/company/:company_id/alternative_namesGet the company details by ID. - GETImages
/3/company/:company_id/imagesGet the company logos by id. - GETDetails
/3/configurationQuery the API configuration details. - GETCountries
/3/configuration/countriesGet the list of countries (ISO 3166-1 tags) used throughout TMDB. - GETJobs
/3/configuration/jobsGet the list of the jobs and departments we use on TMDB. - GETLanguages
/3/configuration/languagesGet the list of languages (ISO 639-1 tags) used throughout TMDB. - GETPrimary Translations
/3/configuration/primary_translationsGet a list of the officially supported translations on TMDB. - GETTimezones
/3/configuration/timezonesGet the list of timezones used throughout TMDB. - GETDetails
/3/credit/:credit_idGet a movie or TV credit details by ID. - GETMovie
/3/discover/movieFind movies using over 30 filters and sort options. - GETTV
/3/discover/tvFind TV shows using over 30 filters and sort options. - GETFind By ID
/3/find/:external_id?external_source=imdb_idFind data by external ID's. - GETMovie List
/3/genre/movie/listGet the list of official genres for movies. - GETTV List
/3/genre/tv/listGet the list of official genres for TV shows. - GETRated Movies
/3/guest_session/:guest_session_id/rated/moviesGet the rated movies for a guest session. - GETRated TV
/3/guest_session/:guest_session_id/rated/tvGet the rated TV shows for a guest session. - GETRated TV Episodes
/3/guest_session/:guest_session_id/rated/tv/episodesGet the rated TV episodes for a guest session. - GETDetails
/3/keyword/:keyword_id - GETMovies
/3/keyword/:keyword_id/movies - POSTAdd Movie
/3/list/:list_id/add_item?session_id=stringAdd a movie to a list. - GETCheck Item Status
/3/list/:list_id/item_statusUse this method to check if an item has already been added to the list. - POSTClear
/3/list/:list_id/clear?session_id=string&confirm=falseClear all items from a list. - POSTCreate
/3/list?session_id=string - GETDetails
/3/list/:list_id - DELETEDelete
/3/list/:list_id?session_id=stringDelete a list. - POSTRemove Movie
/3/list/:list_id/remove_item?session_id=stringRemove a movie from a list. - GETNow Playing
/3/movie/now_playingGet a list of movies that are currently in theatres. - GETPopular
/3/movie/popularGet a list of movies ordered by popularity. - GETTop Rated
/3/movie/top_ratedGet a list of movies ordered by rating. - GETUpcoming
/3/movie/upcomingGet a list of movies that are being released soon. - GETDetails
/3/movie/:movie_idGet the top level details of a movie by ID. - GETAccount States
/3/movie/:movie_id/account_statesGet the rating, watchlist and favourite status of an account. - GETAlternative Titles
/3/movie/:movie_id/alternative_titlesGet the alternative titles for a movie. - GETChanges
/3/movie/:movie_id/changesGet the recent changes for a movie. - GETCredits
/3/movie/:movie_id/credits - GETExternal IDs
/3/movie/:movie_id/external_ids - GETImages
/3/movie/:movie_id/imagesGet the images that belong to a movie. - GETKeywords
/3/movie/:movie_id/keywords - GETLatest
/3/movie/latestGet the newest movie ID. - GETLists
/3/movie/:movie_id/listsGet the lists that a movie has been added to. - GETRecommendations
/3/movie/:movie_id/recommendations - GETRelease Dates
/3/movie/:movie_id/release_datesGet the release dates and certifications for a movie. - GETReviews
/3/movie/:movie_id/reviewsGet the user reviews for a movie. - GETSimilar
/3/movie/:movie_id/similarGet the similar movies based on genres and keywords. - GETTranslations
/3/movie/:movie_id/translationsGet the translations for a movie. - GETVideos
/3/movie/:movie_id/videos - GETWatch Providers
/3/movie/:movie_id/watch/providersGet the list of streaming providers we have for a movie. - POSTAdd Rating
/3/movie/:movie_id/ratingRate a movie and save it to your rated list. - DELETEDelete Rating
/3/movie/:movie_id/ratingDelete a user rating. - GETDetails
/3/network/:network_id - GETAlternative Names
/3/network/:network_id/alternative_namesGet the alternative names of a network. - GETImages
/3/network/:network_id/imagesGet the TV network logos by id. - GETPopular
/3/person/popularGet a list of people ordered by popularity. - GETDetails
/3/person/:person_idQuery the top level details of a person. - GETChanges
/3/person/:person_id/changesGet the recent changes for a person. - GETCombined Credits
/3/person/:person_id/combined_creditsGet the combined movie and TV credits that belong to a person. - GETExternal IDs
/3/person/:person_id/external_idsGet the external ID's that belong to a person. - GETImages
/3/person/:person_id/imagesGet the profile images that belong to a person. - GETLatest
/3/person/latestGet the newest created person. This is a live response and will continuously change. - GETMovie Credits
/3/person/:person_id/movie_creditsGet the movie credits for a person. - GETTV Credits
/3/person/:person_id/tv_creditsGet the TV credits that belong to a person. - GETTagged Images
/3/person/:person_id/tagged_imagesGet the tagged images for a person. - GETTranslations
/3/person/:person_id/translationsGet the translations that belong to a person. - GETDetails
/3/review/:review_idRetrieve the details of a movie or TV show review. - GETCollection
/3/search/collection?query=stringSearch for collections by their original, translated and alternative names. - GETCompany
/3/search/company?query=stringSearch for companies by their original and alternative names. - GETKeyword
/3/search/keyword?query=stringSearch for keywords by their name. - GETMovie
/3/search/movie?query=stringSearch for movies by their original, translated and alternative titles. - GETMulti
/3/search/multi?query=stringUse multi search when you want to search for movies, TV shows and people in a single request. - GETPerson
/3/search/person?query=stringSearch for people by their name and also known as names. - GETTV
/3/search/tv?query=stringSearch for TV shows by their original, translated and also known as names. - GETAll
/3/trending/all/:time_windowGet the trending movies, TV shows and people. - GETMovies
/3/trending/movie/:time_windowGet the trending movies on TMDB. - GETPeople
/3/trending/person/:time_windowGet the trending people on TMDB. - GETTV
/3/trending/tv/:time_windowGet the trending TV shows on TMDB. - GETAiring Today
/3/tv/airing_todayGet a list of TV shows airing today. - GETOn The Air
/3/tv/on_the_airGet a list of TV shows that air in the next 7 days. - GETPopular
/3/tv/popularGet a list of TV shows ordered by popularity. - GETTop Rated
/3/tv/top_ratedGet a list of TV shows ordered by rating. - GETDetails
/3/tv/:series_idGet the details of a TV show. - GETAccount States
/3/tv/:series_id/account_statesGet the rating, watchlist and favourite status. - GETAggregate Credits
/3/tv/:series_id/aggregate_creditsGet the aggregate credits (cast and crew) that have been added to a TV show. - GETAlternative Titles
/3/tv/:series_id/alternative_titlesGet the alternative titles that have been added to a TV show. - GETChanges
/3/tv/:series_id/changesGet the recent changes for a TV show. - GETContent Ratings
/3/tv/:series_id/content_ratingsGet the content ratings that have been added to a TV show. - GETCredits
/3/tv/:series_id/creditsGet the latest season credits of a TV show. - GETEpisode Groups
/3/tv/:series_id/episode_groupsGet the episode groups that have been added to a TV show. - GETExternal IDs
/3/tv/:series_id/external_idsGet a list of external IDs that have been added to a TV show. - GETImages
/3/tv/:series_id/imagesGet the images that belong to a TV series. - GETKeywords
/3/tv/:series_id/keywordsGet a list of keywords that have been added to a TV show. - GETLatest
/3/tv/latestGet the newest TV show ID. - GETLists
/3/tv/:series_id/listsGet the lists that a TV series has been added to. - GETRecommendations
/3/tv/:series_id/recommendations - GETReviews
/3/tv/:series_id/reviewsGet the reviews that have been added to a TV show. - GETScreened Theatrically
/3/tv/:series_id/screened_theatricallyGet the seasons and episodes that have screened theatrically. - GETSimilar
/3/tv/:series_id/similarGet the similar TV shows. - GETTranslations
/3/tv/:series_id/translationsGet the translations that have been added to a TV show. - GETVideos
/3/tv/:series_id/videosGet the videos that belong to a TV show. - GETWatch Providers
/3/tv/:series_id/watch/providersGet the list of streaming providers we have for a TV show. - POSTAdd Rating
/3/tv/:series_id/ratingRate a TV show and save it to your rated list. - DELETEDelete Rating
/3/tv/:series_id/rating - GETDetails
/3/tv/:series_id/season/:season_numberQuery the details of a TV season. - GETAccount States
/3/tv/:series_id/season/:season_number/account_statesGet the rating, watchlist and favourite status. - GETAggregate Credits
/3/tv/:series_id/season/:season_number/aggregate_creditsGet the aggregate credits (cast and crew) that have been added to a TV season. - GETChanges
/3/tv/season/:season_id/changesGet the recent changes for a TV season. - GETCredits
/3/tv/:series_id/season/:season_number/credits - GETExternal IDs
/3/tv/:series_id/season/:season_number/external_idsGet a list of external IDs that have been added to a TV season. - GETImages
/3/tv/:series_id/season/:season_number/imagesGet the images that belong to a TV season. - GETTranslations
/3/tv/:series_id/season/:season_number/translationsGet the translations for a TV season. - GETVideos
/3/tv/:series_id/season/:season_number/videosGet the videos that belong to a TV season. - GETWatch Providers
/3/tv/:series_id/season/:season_number/watch/providersGet the list of streaming providers we have for a TV season. - GETDetails
/3/tv/:series_id/season/:season_number/episode/:episode_numberQuery the details of a TV episode. - GETAccount States
/3/tv/:series_id/season/:season_number/episode/:episode_number/account_statesGet the rating, watchlist and favourite status. - GETChanges
/3/tv/episode/:episode_id/changesGet the recent changes for a TV episode. - GETCredits
/3/tv/:series_id/season/:season_number/episode/:episode_number/credits - GETExternal IDs
/3/tv/:series_id/season/:season_number/episode/:episode_number/external_idsGet a list of external IDs that have been added to a TV episode. - GETImages
/3/tv/:series_id/season/:season_number/episode/:episode_number/imagesGet the images that belong to a TV episode. - GETTranslations
/3/tv/:series_id/season/:season_number/episode/:episode_number/translationsGet the translations that have been added to a TV episode. - GETVideos
/3/tv/:series_id/season/:season_number/episode/:episode_number/videosGet the videos that belong to a TV episode. - POSTAdd Rating
/3/tv/:series_id/season/:season_number/episode/:episode_number/ratingRate a TV episode and save it to your rated list. - DELETEDelete Rating
/3/tv/:series_id/season/:season_number/episode/:episode_number/ratingDelete your rating on a TV episode. - GETDetails
/3/tv/episode_group/:tv_episode_group_idGet the details of a TV episode group. - GETAvailable Regions
/3/watch/providers/regionsGet the list of the countries we have watch provider (OTT/streaming) data for. - GETMovie Providers
/3/watch/providers/movieGet the list of streaming providers we have for movies. - GETTV Providers
/3/watch/providers/tvGet the list of streaming providers we have for TV shows.
API details
- Base URL
https://api.themoviedb.org- Authentication
- An API key in the Authorization header
- Operations
- 152 operations on 148 pathsGET 135POST 12DELETE 5
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
3 - Links
- OpenAPI document
How to test the TMDb in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the TMDb collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Validate Key” (GET /3/authentication), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the TMDb?
TMDb endpoints from Themoviedb It is listed under Media & content and has 152 endpoints.
Who publishes the TMDb?
It is listed from Themoviedb's public API description (an OpenAPI document), not published by Themoviedb on Swastik Codes. Anyone who controls themoviedb.org can claim the profile by adding a DNS TXT record.
What is the base URL of the TMDb?
Requests go to https://api.themoviedb.org. Endpoint paths are added to this base URL.
How do I authenticate with the TMDb?
With an API key in the Authorization header.
How many endpoints does the TMDb have?
152 operations on 148 paths (135 GET, 12 POST, 5 DELETE).
Is forking the TMDb free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.