Masterarbeit

Search

SearchSearch

TMDB API documentation

Jun 20, 202434 min read

Search Link: https://www.google.com/search?channel=fs&client=ubuntu-sn&q=postman+collection+13191452-e12a1487-f709-47b4-9f55-c11c8e0daea2

Overview

POST /tv/{tv_id}/season/{season_number}/episode/{episode_number}/rating

Summary: Rate TV Episode

Rate a TV episode.

A valid session or guest session ID is required. You can read more about how this works here.

DELETE /tv/{tv_id}/season/{season_number}/episode/{episode_number}/rating

Summary: Delete Rating

Remove your rating for a TV episode.

A valid session or guest session ID is required. You can read more about how this works here.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}/rating

GET /tv/{tv_id}/season/{season_number}/episode/{episode_number}

Summary: Get Details

Get the TV episode details by id.

Supports append_to_response. Read more about this here.

Recent Changes

DateChange
June 1, 2018Added the translations method.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}

GET /tv/{tv_id}/season/{season_number}/episode/{episode_number}/external_ids

Summary: Get External IDs

Get the external ids for a TV episode. We currently support the following external sources.

External Sources
IMDb ID
TVDB ID
Freebase MID*
Freebase ID*
TVRage ID*

*Defunct or no longer available as a service.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}/external_ids

GET /tv/{tv_id}/season/{season_number}/episode/{episode_number}/videos

Summary: Get Videos

Get the videos that have been added to a TV episode.

Recent Changes

DateChange
July 28, 2021A new include_video_language filter is now available. You can use this filter the same way you use include_image_language on image calls. We also added two new fields, official and published_at to the video response.
March 23, 2019Vimeo was added as a video source.
March 20, 2019”Behind the Scenes”, “Bloopers” and “Recap” were added as valid video types.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}/videos

GET /tv/{tv_id}/season/{season_number}/episode/{episode_number}/account_states

Summary: Get Account States

Get your rating for a episode.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}/account_states

GET /tv/{tv_id}/season/{season_number}/episode/{episode_number}/translations

Summary: Get Translations

Get the translation data for an episode.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}/translations

GET /tv/{tv_id}/season/{season_number}/episode/{episode_number}/credits

Summary: Get Credits

Get the credits (cast, crew and guest stars) for a TV episode.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}/credits

GET /tv/{tv_id}/season/{season_number}/episode/{episode_number}/images

Summary: Get Images

Get the images that belong to a TV episode.

Querying images with a language parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the include_image_language parameter. This should be a comma seperated value like so: include_image_language=en,null.

PARAMETERS /tv/{tv_id}/season/{season_number}/episode/{episode_number}/images

GET /tv/{tv_id}/season/{season_number}

Summary: Get Details

Get the TV season details by id.

Supports append_to_response. Read more about this here.

PARAMETERS /tv/{tv_id}/season/{season_number}

GET /tv/{tv_id}/season/{season_number}/account_states

Summary: Get Account States

Returns all of the user ratings for the season’s episodes.

PARAMETERS /tv/{tv_id}/season/{season_number}/account_states

GET /tv/{tv_id}/season/{season_number}/aggregate_credits

Summary: Get Aggregate Credits

Get the aggregate credits for TV season.

This call differs from the main credits call in that it does not only return the season credits, but rather is a view of all the cast & crew for all of the episodes belonging to a season.

PARAMETERS /tv/{tv_id}/season/{season_number}/aggregate_credits

GET /tv/{tv_id}/season/{season_number}/videos

Summary: Get Videos

Get the videos that have been added to a TV season.

Recent Changes

DateChange
July 28, 2021A new include_video_language filter is now available. You can use this filter the same way you use include_image_language on image calls. We also added two new fields, official and published_at to the video response.
March 23, 2019Vimeo was added as a video source.
March 20, 2019”Behind the Scenes” and “Bloopers” and “Recap” were added as valid video types.

PARAMETERS /tv/{tv_id}/season/{season_number}/videos

GET /tv/{tv_id}/season/{season_number}/external_ids

Summary: Get External IDs

Get the external ids for a TV season. We currently support the following external sources.

Media Databases
TVDB ID
Freebase MID*
Freebase ID*
TVRage ID*

*Defunct or no longer available as a service.

PARAMETERS /tv/{tv_id}/season/{season_number}/external_ids

GET /tv/{tv_id}/season/{season_number}/credits

Summary: Get Credits

Get the credits for TV season.

PARAMETERS /tv/{tv_id}/season/{season_number}/credits

GET /tv/{tv_id}/season/{season_number}/images

Summary: Get Images

Get the images that belong to a TV season.

Querying images with a language parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the include_image_language parameter. This should be a comma seperated value like so: include_image_language=en,null.

PARAMETERS /tv/{tv_id}/season/{season_number}/images

GET /tv/{tv_id}/season/{season_number}/translations

Summary: Get Translations

Get the credits for TV season.

PARAMETERS /tv/{tv_id}/season/{season_number}/translations

POST /tv/{tv_id}/rating

Summary: Rate TV Show

Rate a TV show.

A valid session or guest session ID is required. You can read more about how this works here.

DELETE /tv/{tv_id}/rating

Summary: Delete Rating

Remove your rating for a TV show.

A valid session or guest session ID is required. You can read more about how this works here.

PARAMETERS /tv/{tv_id}/rating

GET /tv/{tv_id}

Summary: Get Details

Get the primary TV show details by id.

Supports append_to_response. Read more about this here.

Recent Changes

DateChange
November 20, 2020A watch/providers method has been added to show what providers (eg. streaming) are available and where.
November 14, 2020The tagline has been added to the default response, and is also available as part of the translations method.
July 17, 2018We now return last_episode_to_air and next_episode_to_air fields.
March 12, 2018Networks return proper logos and we introduced SVG support.
March 8, 2018The seasons field now returns the translated names and overviews.

PARAMETERS /tv/{tv_id}

GET /tv/{tv_id}/alternative_titles

Summary: Get Alternative Titles

Returns all of the alternative titles for a TV show.

PARAMETERS /tv/{tv_id}/alternative_titles

GET /tv/{tv_id}/aggregate_credits

Summary: Get Aggregate Credits

Get the aggregate credits (cast and crew) that have been added to a TV show.

This call differs from the main credits call in that it does not return the newest season but rather, is a view of all the entire cast & crew for all episodes belonging to a TV show.

PARAMETERS /tv/{tv_id}/aggregate_credits

GET /tv/{tv_id}/similar

Summary: Get Similar TV Shows

Get a list of similar TV shows. These items are assembled by looking at keywords and genres.

PARAMETERS /tv/{tv_id}/similar

GET /tv/{tv_id}/content_ratings

Summary: Get Content Ratings

Get the list of content ratings (certifications) that have been added to a TV show.

PARAMETERS /tv/{tv_id}/content_ratings

GET /tv/{tv_id}/translations

Summary: Get Translations

Get a list of the translations that exist for a TV show.

PARAMETERS /tv/{tv_id}/translations

GET /tv/{tv_id}/account_states

Summary: Get Account States

Grab the following account states for a session:

  • TV show rating
  • If it belongs to your watchlist
  • If it belongs to your favourite list

PARAMETERS /tv/{tv_id}/account_states

GET /tv/{tv_id}/episode_groups

Summary: Get Episode Groups

Get all of the episode groups that have been created for a TV show. With a group ID you can call the get TV episode group details method.

PARAMETERS /tv/{tv_id}/episode_groups

GET /tv/{tv_id}/images

Summary: Get Images

Get the images that belong to a TV show.

Querying images with a language parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the include_image_language parameter. This should be a comma seperated value like so: include_image_language=en,null.

PARAMETERS /tv/{tv_id}/images

GET /tv/{tv_id}/reviews

Summary: Get Reviews

Get the reviews for a TV show.

PARAMETERS /tv/{tv_id}/reviews

GET /tv/{tv_id}/watch/providers

Summary: Get Watch Providers

Powered by our partnership with JustWatch, you can query this method to get a list of the availabilities per country by provider.

This is not going to return full deep links, but rather, it’s just enough information to display what’s available where.

You can link to the provided TMDB URL to help support TMDB and provide the actual deep links to the content.

Please note: In order to use this data you must attribute the source of the data as JustWatch. If we find any usage not complying with these terms we will revoke access to the API.

PARAMETERS /tv/{tv_id}/watch/providers

GET /tv/{tv_id}/videos

Summary: Get Videos

Get the videos that have been added to a TV show.

Recent Changes

DateChange
July 28, 2021A new include_video_language filter is now available. You can use this filter the same way you use include_image_language on image calls. We also added two new fields, official and published_at to the video response.
March 23, 2019Vimeo was added as a video source.
March 20, 2019”Behind the Scenes” and “Bloopers” were added as valid video types.

PARAMETERS /tv/{tv_id}/videos

GET /tv/{tv_id}/keywords

Summary: Get Keywords

Get the keywords that have been added to a TV show.

PARAMETERS /tv/{tv_id}/keywords

GET /tv/{tv_id}/external_ids

Summary: Get External IDs

Get the external ids for a TV show. We currently support the following external sources.

Media DatabasesSocial IDs
IMDb IDFacebook
TVDB IDInstagram
Freebase MID*Twitter
Freebase ID*
TVRage ID*

*Defunct or no longer available as a service.

PARAMETERS /tv/{tv_id}/external_ids

GET /tv/{tv_id}/changes

Summary: Get Changes

Get the changes for a TV show. By default only the last 24 hours are returned.

You can query up to 14 days in a single query by using the start_date and end_date query parameters.

TV show changes are different than movie changes in that there are some edits on seasons and episodes that will create a change entry at the show level. These can be found under the season and episode keys. These keys will contain a series_id and episode_id. You can use the season changes and episode changes methods to look these up individually.

PARAMETERS /tv/{tv_id}/changes

GET /tv/{tv_id}/credits

Summary: Get Credits

Get the credits (cast and crew) that have been added to a TV show.

PARAMETERS /tv/{tv_id}/credits

GET /tv/{tv_id}/screened_theatrically

Summary: Get Screened Theatrically

Get a list of seasons or episodes that have been screened in a film festival or theatre.

PARAMETERS /tv/{tv_id}/screened_theatrically

GET /tv/{tv_id}/recommendations

Summary: Get Recommendations

Get the list of TV show recommendations for this item.

PARAMETERS /tv/{tv_id}/recommendations

GET /tv/top_rated

Summary: Get Top Rated

Get a list of the top rated TV shows on TMDB.

GET /tv/latest

Summary: Get Latest

Get the most newly created TV show. This is a live response and will continuously change.

GET /tv/changes

Summary: Get TV Change List

Get a list of all of the TV show ids that have been changed in the past 24 hours.

You can query it for up to 14 days worth of changed IDs at a time with the start_date and end_date query parameters. 100 items are returned per page.

GET /tv/episode_group/{id}

Summary: Get Details

Get the details of a TV episode group. Groups support 7 different types which are enumerated as the following:

  1. Original air date
  2. Absolute
  3. DVD
  4. Digital
  5. Story arc
  6. Production
  7. TV

PARAMETERS /tv/episode_group/{id}

GET /tv/popular

Summary: Get Popular

Get a list of the current popular TV shows on TMDB. This list updates daily.

GET /tv/on_the_air

Summary: Get TV On The Air

Get a list of shows that are currently on the air.

This query looks for any TV show that has an episode with an air date in the next 7 days.

GET /tv/season/{season_id}/changes

Summary: Get Changes

Get the changes for a TV season. By default only the last 24 hours are returned.

You can query up to 14 days in a single query by using the start_date and end_date query parameters.

PARAMETERS /tv/season/{season_id}/changes

GET /tv/airing_today

Summary: Get TV Airing Today

Get a list of TV shows that are airing today. This query is purely day based as we do not currently support airing times.

You can specify a timezone to offset the day calculation. Without a specified timezone, this query defaults to EST (Eastern Time UTC-05:00).

GET /tv/episode/{episode_id}/changes

Summary: Get Changes

Get the changes for a TV episode. By default only the last 24 hours are returned.

You can query up to 14 days in a single query by using the start_date and end_date query parameters.

PARAMETERS /tv/episode/{episode_id}/changes

GET /discover/tv

Summary: TV Discover

Discover TV shows by different types of data like average rating, number of votes, genres, the network they aired on and air dates.

Discover also supports a nice list of sort options. See below for all of the available options.

Also note that a number of filters support being comma (,) or pipe (|) separated. Comma’s are treated like an AND and query while pipe’s are an OR.

Some examples of what can be done with discover can be found here.

Recent Changes

DateChange
April 13, 2021A new with_watch_monetization_types filter is available to use with watch_region.
January 2, 2021A new set of filters are available for watch provider filtering. Check out with_watch_providers and watch_region.

GET /discover/movie

Summary: Movie Discover

Discover movies by different types of data like average rating, number of votes, genres and certifications. You can get a valid list of certifications from the certifications list method.

Discover also supports a nice list of sort options. See below for all of the available options.

Please note, when using certification \ certification.lte you must also specify certification_country. These two parameters work together in order to filter the results. You can only filter results with the countries we have added to our certifications list.

If you specify the region parameter, the regional release date will be used instead of the primary release date. The date returned will be the first date based on your query (ie. if a with_release_type is specified). It’s important to note the order of the release types that are used. Specifying “2|3” would return the limited theatrical release date as opposed to “3|2” which would return the theatrical date.

Also note that a number of filters support being comma (,) or pipe (|) separated. Comma’s are treated like an AND and query while pipe’s are an OR.

Some examples of what can be done with discover can be found here.

Recent Changes

DateChange
April 13, 2021A new with_watch_monetization_types filter is available to use with watch_region.
January 2, 2021A new set of filters are available for watch provider filtering. Check out with_watch_providers and watch_region.

DELETE /authentication/session

Summary: Delete Session

If you would like to delete (or “logout”) from a session, call this method with a valid session ID.

POST /authentication/session/new

Summary: Create Session

You can use this method to create a fully valid session ID once a user has validated the request token. More information about how this works can be found here.

POST /authentication/session/convert/4

Summary: Create Session (from v4 access token)

Use this method to create a v3 session ID if you already have a valid v4 access token. The v4 token needs to be authenticated by the user. Your standard “read token” will not validate to create a session ID.

GET /authentication/token/new

Summary: Create Request Token

Create a temporary request token that can be used to validate a TMDB user login. More details about how this works can be found here.

POST /authentication/token/validate_with_login

Summary: Create Session With Login

This method allows an application to validate a request token by entering a username and password.

Not all applications have access to a web view so this can be used as a substitute.

Please note, the preferred method of validating a request token is to have a user authenticate the request via the TMDB website. You can read about that method here.

If you decide to use this method please use HTTPS.

GET /authentication/guest_session/new

Summary: Create Guest Session

This method will let you create a new guest session. Guest sessions are a type of session that will let a user rate movies and TV shows but not require them to have a TMDB user account. More information about user authentication can be found here.

Please note, you should only generate a single guest session per user (or device) as you will be able to attach the ratings to a TMDB user account in the future. There is also IP limits in place so you should always make sure it’s the end user doing the guest session actions.

If a guest session is not used for the first time within 24 hours, it will be automatically deleted.

GET /list/{list_id}

Summary: Get Details

Get the details of a list.

DELETE /list/{list_id}

Summary: Delete List

Delete a list.

PARAMETERS /list/{list_id}

POST /list/{list_id}/add_item

Summary: Add Movie

Add a movie to a list.

PARAMETERS /list/{list_id}/add_item

POST /list/{list_id}/remove_item

Summary: Remove Movie

Remove a movie from a list.

PARAMETERS /list/{list_id}/remove_item

POST /list/{list_id}/clear

Summary: Clear List

Clear all of the items from a list.

PARAMETERS /list/{list_id}/clear

GET /list/{list_id}/item_status

Summary: Check Item Status

You can use this method to check if a movie has already been added to the list.

PARAMETERS /list/{list_id}/item_status

POST /list

Summary: Create List

Create a list.

POST /movie/{movie_id}/rating

Summary: Rate Movie

Rate a movie.

A valid session or guest session ID is required. You can read more about how this works here.

DELETE /movie/{movie_id}/rating

Summary: Delete Rating

Remove your rating for a movie.

A valid session or guest session ID is required. You can read more about how this works here.

PARAMETERS /movie/{movie_id}/rating

GET /movie/{movie_id}

Summary: Get Details

Get the primary information about a movie.

Supports append_to_response. Read more about this here.

Recent Changes

DateChange
November 20, 2020A watch/providers method has been added to show what providers (eg. streaming) are available and where.

PARAMETERS /movie/{movie_id}

GET /movie/{movie_id}/translations

Summary: Get Translations

Get a list of translations that have been created for a movie.

PARAMETERS /movie/{movie_id}/translations

GET /movie/{movie_id}/external_ids

Summary: Get External IDs

Get the external ids for a movie. We currently support the following external sources.

Media DatabasesSocial IDs
IMDb IDFacebook
Instagram
Twitter

PARAMETERS /movie/{movie_id}/external_ids

GET /movie/{movie_id}/changes

Summary: Get Changes

Get the changes for a movie. By default only the last 24 hours are returned.

You can query up to 14 days in a single query by using the start_date and end_date query parameters.

PARAMETERS /movie/{movie_id}/changes

GET /movie/{movie_id}/alternative_titles

Summary: Get Alternative Titles

Get all of the alternative titles for a movie.

Recent Changes

DateChange
March 16, 2018Added the type field.

PARAMETERS /movie/{movie_id}/alternative_titles

GET /movie/{movie_id}/videos

Summary: Get Videos

Get the videos that have been added to a movie.

Recent Changes

DateChange
July 28, 2021A new include_video_language filter is now available. You can use this filter the same way you use include_image_language on image calls. We also added two new fields, official and published_at to the video response.
March 23, 2019Vimeo was added as a video source.
March 20, 2019”Behind the Scenes” and “Bloopers” were added as valid video types.

PARAMETERS /movie/{movie_id}/videos

GET /movie/{movie_id}/account_states

Summary: Get Account States

Grab the following account states for a session:

  • Movie rating
  • If it belongs to your watchlist
  • If it belongs to your favourite list

PARAMETERS /movie/{movie_id}/account_states

GET /movie/{movie_id}/lists

Summary: Get Lists

Get a list of lists that this movie belongs to.

PARAMETERS /movie/{movie_id}/lists

GET /movie/{movie_id}/similar

Summary: Get Similar Movies

Get a list of similar movies. This is not the same as the “Recommendation” system you see on the website.

These items are assembled by looking at keywords and genres.

PARAMETERS /movie/{movie_id}/similar

GET /movie/{movie_id}/recommendations

Summary: Get Recommendations

Get a list of recommended movies for a movie.

PARAMETERS /movie/{movie_id}/recommendations

GET /movie/{movie_id}/watch/providers

Summary: Get Watch Providers

Powered by our partnership with JustWatch, you can query this method to get a list of the availabilities per country by provider.

This is not going to return full deep links, but rather, it’s just enough information to display what’s available where.

You can link to the provided TMDB URL to help support TMDB and provide the actual deep links to the content.

Please note: In order to use this data you must attribute the source of the data as JustWatch. If we find any usage not complying with these terms we will revoke access to the API.

PARAMETERS /movie/{movie_id}/watch/providers

GET /movie/{movie_id}/keywords

Summary: Get Keywords

Get the keywords that have been added to a movie.

PARAMETERS /movie/{movie_id}/keywords

GET /movie/{movie_id}/release_dates

Summary: Get Release Dates

Get the release date along with the certification for a movie.

Release dates support different types:

  1. Premiere
  2. Theatrical (limited)
  3. Theatrical
  4. Digital
  5. Physical
  6. TV

PARAMETERS /movie/{movie_id}/release_dates

GET /movie/{movie_id}/reviews

Summary: Get Reviews

Get the user reviews for a movie.

PARAMETERS /movie/{movie_id}/reviews

GET /movie/{movie_id}/credits

Summary: Get Credits

Get the cast and crew for a movie.

PARAMETERS /movie/{movie_id}/credits

GET /movie/{movie_id}/images

Summary: Get Images

Get the images that belong to a movie.

Querying images with a language parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the include_image_language parameter. This should be a comma seperated value like so: include_image_language=en,null.

PARAMETERS /movie/{movie_id}/images

GET /movie/now_playing

Summary: Get Now Playing

Get a list of movies in theatres. This is a release type query that looks for all movies that have a release type of 2 or 3 within the specified date range.

You can optionally specify a region prameter which will narrow the search to only look for theatrical release dates within the specified country.

GET /movie/popular

Summary: Get Popular

Get a list of the current popular movies on TMDB. This list updates daily.

GET /movie/upcoming

Summary: Get Upcoming

Get a list of upcoming movies in theatres. This is a release type query that looks for all movies that have a release type of 2 or 3 within the specified date range.

You can optionally specify a region prameter which will narrow the search to only look for theatrical release dates within the specified country.

GET /movie/latest

Summary: Get Latest

Get the most newly created movie. This is a live response and will continuously change.

GET /movie/top_rated

Summary: Get Top Rated

Get the top rated movies on TMDB.

GET /movie/changes

Summary: Get Movie Change List

Get a list of all of the movie ids that have been changed in the past 24 hours.

You can query it for up to 14 days worth of changed IDs at a time with the start_date and end_date query parameters. 100 items are returned per page.

GET /configuration

Summary: Get API Configuration

Get the system wide configuration information. Some elements of the API require some knowledge of this configuration data. The purpose of this is to try and keep the actual API responses as light as possible. It is recommended you cache this data within your application and check for updates every few days.

This method currently holds the data relevant to building image URLs as well as the change key map.

To build an image URL, you will need 3 pieces of data. The base_url, size and file_path. Simply combine them all and you will have a fully qualified URL. Here’s an example URL:

https://image.tmdb.org/t/p/w500/8uO0gUM8aNqYLs1OsTBQiXu0fEv.jpg

The configuration method also contains the list of change keys which can be useful if you are building an app that consumes data from the change feed.

GET /configuration/jobs

Summary: Get Jobs

Get a list of the jobs and departments we use on TMDB.

GET /configuration/timezones

Summary: Get Timezones

Get the list of timezones used throughout TMDB.

GET /configuration/countries

Summary: Get Countries

Get the list of countries (ISO 3166-1 tags) used throughout TMDB.

GET /configuration/primary_translations

Summary: Get Primary Translations

Get a list of the officially supported translations on TMDB.

While it’s technically possible to add a translation in any one of the languages we have added to TMDB (we don’t restrict content), the ones listed in this method are the ones we also support for localizing the website with which means they are what we refer to as the “primary” translations.

These are all specified as IETF tags to identify the languages we use on TMDB. There is one exception which is image languages. They are currently only designated by a ISO-639-1 tag. This is a planned upgrade for the future.

We’re always open to adding more if you think one should be added. You can ask about getting a new primary translation added by posting on the forums.

One more thing to mention, these are the translations that map to our website translation project. You can view and contribute to that project here.

GET /configuration/languages

Summary: Get Languages

Get the list of languages (ISO 639-1 tags) used throughout TMDB.

GET /company/{company_id}

Summary: Get Details

Get a companies details by id.

PARAMETERS /company/{company_id}

GET /company/{company_id}/images

Summary: Get Images

Get a companies logos by id.

There are two image formats that are supported for companies, PNG’s and SVG’s. You can see which type the original file is by looking at the file_type field. We prefer SVG’s as they are resolution independent and as such, the width and height are only there to reflect the original asset that was uploaded. An SVG can be scaled properly beyond those dimensions if you call them as a PNG.

For more information about how SVG’s and PNG’s can be used, take a read through this document.

PARAMETERS /company/{company_id}/images

GET /company/{company_id}/alternative_names

Summary: Get Alternative Names

Get the alternative names of a company.

PARAMETERS /company/{company_id}/alternative_names

GET /search/keyword

Summary: Search Keywords

Search for keywords.

GET /search/person

Summary: Search People

Search for people.

GET /search/collection

Summary: Search Collections

Search for collections.

GET /search/company

Summary: Search Companies

Search for companies.

GET /search/tv

Summary: Search TV Shows

Search for a TV show.

GET /search/movie

Summary: Search Movies

Search for movies.

GET /search/multi

Summary: Multi Search

Search multiple models in a single request. Multi search currently supports searching for movies, tv shows and people in a single request.

POST /account/{account_id}/watchlist

Summary: Add to Watchlist

Add a movie or TV show to your watchlist.

PARAMETERS /account/{account_id}/watchlist

GET /account/{account_id}/watchlist/tv

Summary: Get TV Show Watchlist

Get a list of all the TV shows you have added to your watchlist.

PARAMETERS /account/{account_id}/watchlist/tv

GET /account/{account_id}/watchlist/movies

Summary: Get Movie Watchlist

Get a list of all the movies you have added to your watchlist.

PARAMETERS /account/{account_id}/watchlist/movies

POST /account/{account_id}/favorite

Summary: Mark as Favorite

This method allows you to mark a movie or TV show as a favorite item.

PARAMETERS /account/{account_id}/favorite

GET /account/{account_id}/favorite/tv

Summary: Get Favorite TV Shows

Get the list of your favorite TV shows.

PARAMETERS /account/{account_id}/favorite/tv

GET /account/{account_id}/favorite/movies

Summary: Get Favorite Movies

Get the list of your favorite movies.

PARAMETERS /account/{account_id}/favorite/movies

GET /account/{account_id}/rated/tv

Summary: Get Rated TV Shows

Get a list of all the TV shows you have rated.

PARAMETERS /account/{account_id}/rated/tv

GET /account/{account_id}/rated/tv/episodes

Summary: Get Rated TV Episodes

Get a list of all the TV episodes you have rated.

PARAMETERS /account/{account_id}/rated/tv/episodes

GET /account/{account_id}/rated/movies

Summary: Get Rated Movies

Get a list of all the movies you have rated.

PARAMETERS /account/{account_id}/rated/movies

GET /account/{account_id}/lists

Summary: Get Created Lists

Get all of the lists created by an account. Will invlude private lists if you are the owner.

PARAMETERS /account/{account_id}/lists

GET /account

Summary: Get Details

Get your account details.

GET /person/{person_id}

Summary: Get Details

Get the primary person details by id.

Supports append_to_response. Read more about this here.

Recent Changes

DateChange
July 17, 2018Added the known_for_department field.
April 26, 2018Added the translations method.
November 9, 2016Biographies are now translatable on TMDB. This means you can query person details with a language parameter.

PARAMETERS /person/{person_id}

GET /person/{person_id}/external_ids

Summary: Get External IDs

Get the external ids for a person. We currently support the following external sources.

External Sources
IMDB ID
Facebook
Freebase MID
Freebase ID
Instagram
TVRage ID
Twitter

PARAMETERS /person/{person_id}/external_ids

GET /person/{person_id}/combined_credits

Summary: Get Combined Credits

Get the movie and TV credits together in a single response.

PARAMETERS /person/{person_id}/combined_credits

GET /person/{person_id}/changes

Summary: Get Changes

Get the changes for a person. By default only the last 24 hours are returned.

You can query up to 14 days in a single query by using the start_date and end_date query parameters.

PARAMETERS /person/{person_id}/changes

GET /person/{person_id}/tv_credits

Summary: Get TV Credits

Get the TV show credits for a person.

You can query for some extra details about the credit with the credit method.

PARAMETERS /person/{person_id}/tv_credits

GET /person/{person_id}/movie_credits

Summary: Get Movie Credits

Get the movie credits for a person.

PARAMETERS /person/{person_id}/movie_credits

GET /person/{person_id}/translations

Summary: Get Translations

Get a list of translations that have been created for a person.

PARAMETERS /person/{person_id}/translations

GET /person/{person_id}/tagged_images

Summary: Get Tagged Images

Get the images that this person has been tagged in.

PARAMETERS /person/{person_id}/tagged_images

GET /person/{person_id}/images

Summary: Get Images

Get the images for a person.

PARAMETERS /person/{person_id}/images

GET /person/latest

Summary: Get Latest

Get the most newly created person. This is a live response and will continuously change.

GET /person/changes

Summary: Get Person Change List

Get a list of all of the person ids that have been changed in the past 24 hours.

You can query it for up to 14 days worth of changed IDs at a time with the start_date and end_date query parameters. 100 items are returned per page.

GET /person/popular

Summary: Get Popular

Get the list of popular people on TMDB. This list updates daily.

GET /keyword/{keyword_id}

Summary: Get Details

Get Details

PARAMETERS /keyword/{keyword_id}

GET /keyword/{keyword_id}/movies

Summary: Get Movies

Get the movies that belong to a keyword.

We highly recommend using movie discover instead of this method as it is much more flexible.

PARAMETERS /keyword/{keyword_id}/movies

GET /network/{network_id}

Summary: Get Details

Get the details of a network.

Recent Changes

DateChange
November 14, 2020The logo_path has been added to the default response.

PARAMETERS /network/{network_id}

GET /network/{network_id}/alternative_names

Summary: Get Alternative Names

Get the alternative names of a network.

PARAMETERS /network/{network_id}/alternative_names

GET /network/{network_id}/images

Summary: Get Images

Get the TV network logos by id.

There are two image formats that are supported for networks, PNG’s and SVG’s. You can see which type the original file is by looking at the file_type field. We prefer SVG’s as they are resolution independent and as such, the width and height are only there to reflect the original asset that was uploaded. An SVG can be scaled properly beyond those dimensions if you call them as a PNG.

For more information about how SVG’s and PNG’s can be used, take a read through this document.

PARAMETERS /network/{network_id}/images

GET /certification/movie/list

Summary: Get Movie Certifications

Get an up to date list of the officially supported movie certifications on TMDB.

GET /certification/tv/list

Summary: Get TV Certifications

Get an up to date list of the officially supported TV show certifications on TMDB.

GET /watch/providers/regions

Summary: Get Available Regions

Returns a list of all of the countries we have watch provider (OTT/streaming) data for.

GET /watch/providers/tv

Summary: Get TV Providers

Returns a list of the watch provider (OTT/streaming) data we have available for TV series. You can specify a watch_region param if you want to further filter the list by country.

GET /watch/providers/movie

Summary: Get Movie Providers

Returns a list of the watch provider (OTT/streaming) data we have available for movies. You can specify a watch_region param if you want to further filter the list by country.

GET /guest_session/{guest_session_id}/rated/tv

Summary: Get Rated TV Shows

Get the rated TV shows for a guest session.

PARAMETERS /guest_session/{guest_session_id}/rated/tv

GET /guest_session/{guest_session_id}/rated/tv/episodes

Summary: Get Rated TV Episodes

Get the rated TV episodes for a guest session.

PARAMETERS /guest_session/{guest_session_id}/rated/tv/episodes

GET /guest_session/{guest_session_id}/rated/movies

Summary: Get Rated Movies

Get the rated movies for a guest session.

PARAMETERS /guest_session/{guest_session_id}/rated/movies

GET /collection/{collection_id}

Summary: Get Details

Get collection details by id.

Recent Changes

DateChange
March 16, 2018Added the translations method.

PARAMETERS /collection/{collection_id}

GET /collection/{collection_id}/images

Summary: Get Images

Get the images for a collection by id.

PARAMETERS /collection/{collection_id}/images

GET /collection/{collection_id}/translations

Summary: Get Translations

Get the list translations for a collection by id.

PARAMETERS /collection/{collection_id}/translations

GET /genre/movie/list

Summary: Get Movie List

Get the list of official genres for movies.

GET /genre/tv/list

Summary: Get TV List

Get the list of official genres for TV shows.

GET /trending/{media_type}/{time_window}

Summary: Get Trending

Get the daily or weekly trending items. The daily trending list tracks items over the period of a day while items have a 24 hour half life. The weekly list tracks items over a 7 day period, with a 7 day half life.

Valid Media Types

Media TypeDescription
allInclude all movies, TV shows and people in the results as a global trending list.
movieShow the trending movies in the results.
tvShow the trending TV shows in the results.
personShow the trending people in the results.

Valid Time Windows

Time WindowDescription
dayView the trending list for the day.
weekView the trending list for the week.

PARAMETERS /trending/{media_type}/{time_window}

GET /review/{review_id}

Summary: Get Details

Retrieve the details of a movie or TV show review.

Recent Changes

DateChange
November 14, 2020A author_details field has been added to the default response, which includes an avatar_path and rating value.

PARAMETERS /review/{review_id}

GET /credit/{credit_id}

Summary: Get Details

Get a movie or TV credit details by id.

Recent Changes

DateChange
July 13, 2018Movie credits are now supported.

PARAMETERS /credit/{credit_id}

GET /find/{external_id}

Summary: Find by ID

The find method makes it easy to search for objects in our database by an external id.

This method will search all objects (movies, TV shows and people) and return the results in a single response.

The supported external sources for each object are as follows.

Media Databases

MoviesTV ShowsTV SeasonsTV EpisodesPeople
IMDb ID✓✓✗✓✓
TVDB ID✗✓✓✓✗
Freebase MID*✗✓✓✓✓
Freebase ID*✗✓✓✓✓
TVRage ID*✗✓✓✓✓

Social IDs

MoviesTV ShowsTV SeasonsTV EpisodesPeople
Facebook✓✓✗✗✓
Instagram✓✓✗✗✓
Twitter✓✓✗✗✓

*Defunct or no longer available as a service.

PARAMETERS /find/{external_id}

Graph View

Backlinks

  • No backlinks found