Get answers to frequently asked questions

TMDB API

Introduction

Kickstart your integration with TMDB API 

Getting Started

Authentication

Guest Session

Get to know more about the errors you come across when using TMDB API 

Error Codes

Get to know how TMDB API rate limit works

Rate Limit

This endpoint allows you to create a request token.

Create Request Token

This endpoint allows you to create a session ID with your request token.

Check this [section](https://starlight.mintlify.app/api-reference/sessionid) for more information about `session_id`.

Create Session ID

This endpoint allows you to validate a request token by using a username and password.

Create Session ID(with login)

This endpoint allows you to delete a session ID.

Delete Session

This endpoint allows you to test the validity of your API key.

Validate Key

This endpoint allows you to create a guest session Id.

Check this [section](https://starlight.mintlify.app/api-reference/guestoverview) for more information about guest session.

Guest SessionId

This endpoint allows you to retrieve our API configuration details.

Details

This endpoint allows you to retrieve the list of countries used throughout the TMDB API.

Countries

This endpoint allows you to retrieve the list of jobs and departments in TMDB.

Jobs

This endpoint allows you to retrieve the list of languages used throughout the TMDB API.

Language

This set of fields retrieves the list of officially supported translations in TMDB.

Primary Translations

This endpoint retrieves the list of timezones used in TMDB.

Timezones

This endpoint retrieves account details by session Id.

Details By SessionId

This endpoint retrieves account details by account Id.


    

Details By AccountId

This endpoint allows you to add a movie or TV show as a favorite.
    

Add Favorite

This endpoint allows you to add a movie or TV show to your watchlist.

Add To Watchlist

This endpoint retrieves a list of your favorite movies.

Favorite Movies

This endpoint retrieves a list of your favorite TV shows.

Favorite TV

This endpoint retrieves the list you have created. E.g., your movie list.

Lists

This endpoint retrieves a list of movies you have rated.
     

Rated Movies

This represents the list of TV shows you have rated.

Rated TV

This endpoint retrieves the list of TV episodes you have rated.

   

Rated TV Episodes

This endpoint retrieves your movie watchlist. 

Movies Watchlist

This endpoint retrieves your TV watchlist.

TV Watchlist

This endpoint allows you to search for collections by their original, translated, and alternative names.

Collection

This endpoint allows you to search for companies by their original, translated, and alternative names.

Company

This endpoint allows you to search for keywords by their name.

Keyword

This endpoint allows you to search for movies by their original, translated, and alternative names.

Movie

This endpoint allows you to multi-search in one request. It retrieves multiple media types including TV shows, movies, and people in a single request.

Multi Search

This endpoint allows you to search for persons by their names and known names.

Person

This endpoint allows you to search for TV shows by their original, translated, and alternative names.

This endpoint allows you to find movies with over 30 filters and sort options.

Check this [section](https://starlight.mintlify.app/api-reference/filter) for more information about how filter works. 

This endpoint allows you to find TV shows with over 30 filters and sort options.
Check this [section](https://starlight.mintlify.app/api-reference/filter) for more information about how filter works. 

This endpoint allows you to search for all objects in our database, including movies, TV shows, and persons, by an external ID.

Find By External ID

This endpoint allows you to look for a particular keyword by Id.

Keyword by Id

This endpoint allows you to add a movie to your list.        

Add Movie

This endpoint allows you to check if an item has been added to the list.

Check Item Status

This endpoint allows you to create a list.

Create

This endpoint allows you to clear all items in your list.            

Clear

This endpoint retrieves the details of a list.

This endpoint allows you to delete your list.

Delete

This endpoint allows you to remove a movie from your list.

Remove Movie

This endpoint retrieves collection details by ID.

This endpoint retrieves the information about images in the collection.

Images

This endpoint retrieves the translation of the collection.

Translations

This endpoint allows you to retrieve the details of an entertainment company by Id.

This endpoint retrieves the alternative name of an entertainment company.

Alternative Names

This endpoint allows you to retrieve the logo of an entertainment company by Id.

This endpoint retrieves the details of a TV or movie network.            

This endpoint retrieves the alternative names of a particular network.            

This endpoint retrieves the TV network logos by id.

This endpoint allows you to search for all trending movies, TV shows, and people.

This endpoint retrieves all trending movies on TMDB.

Movies

This endpoint retrieves a list of all popular people on TMDB.

People

This endpoint retrieves a list of top-rated TV shows.

Top Rated

This endpoint allows you to retrieve top-level details of a movie by its Id.

This endpoint allows you to check if a movie has been added to favorite, rated, or watchlist in your account.

Movie States

This endpoint retrieves the alternative titles of a particular movie.

Alternative Title

This endpoint retrieves the list of recent changes made to a movie.


 <Note>
    Important note

    You can only query up to 14 days in a single query by using the `start_date` and `end_date` query parameters. If not specified, it retrieves changes made in the last 24 hours.


</Note>

Changes

This endpoint retrieves the list of people's roles in the movie.

Credit

This endpoint retrieves the list of external Id of a particular movie

External IDs

This endpoint retrieves a list of images that belong to the movie. It returns logos, posters, and backdrops that have been added to the movie.]


< Note> There are two image formats that are supported for companies: PNG's and SVG's. Check this [document](https://developer.themoviedb.org/docs/images) for more information.


</Note>   



This endpoint retrieves the list of keywords associated with a movie.

Keywords

This endpoint retrieves a list of the latest movies. It is a live request and will continuously change.

Latest

This endpoint retrieves the list that the movie has been added to.

This endpoint retrieves a list of recommended movies.

Recommendations

This endpoint retrieves the release dates and certifications of a movie.

    
 For more information about TMDB release dates and statuses, check the
[Release types](https://starlight.mintlify.app/api-reference/releasedates) section.

Release Dates

This endpoint retrieves the list of reviews of a particular movie.

Reviews

This endpoint retrieves a list of similar movies based on keywords and genres.

Similar

This endpoint retrieves the movie translations.


For more information about languages on TMDB, check our documentation [here](https://developer.themoviedb.org/docs/languages).

This endpoint retrieves a list of videos associated with a particular movie.

Videos

This endpoint retrieves a list of streaming providers for a particular movie.



<Note>
  Important Note

   To use this data, you must attribute the source as **JustWatch**. If we find any usage that does not comply with these terms we will revoken access to the API.



</Note>

    

Streaming  Providers

This endpoint allows you to rate a movie.


<Note>
  Important Note

          If the movie you rated is on your watchlist, it will be automatically removed. This keeps your "watched" and "want to watch" lists tidy and in sync. You can edit this behavior [here](https://www.themoviedb.org/settings/sharing).

  </Note>



    

Add Ratings

This endpoint allows you to delete a movie rating.

Delete Rating

This endpoint retrieves a list of movies that are currently in theatres.

To get more advanced filter options, check the [discover](https://starlight.mintlify.app/api-reference/discover/movie) endpoint.

Now Playing

This endpoint retrieves a list of popular movies.

To get more advanced filter options, check the [discover](https://starlight.mintlify.app/api-reference/discover/movie)     endpoint.

Upcoming

This endpoint retrieves the details of a TV show.

This endpoint allows you to check if a TV series has been added to your watchlist, favorite, and ratings.

Account States

This endpoint retrieves the aggregate credits (acting and crew) that have been added to a TV show.

Aggregate Credits

This endpoint retrieves the alternative titles of a TV show.

Alternative Titles

This endpoint retrieves the recent changes that have been made to a TV show.




 You can query this endpoint within the range of 14 days by using
`start_date` and `end_date`. If not specified, it retrieves changes that were made in the last 24 hours.
    

This endpoint retrieves the content ratings that have been added to a TV show.

Content Ratings

This endpoint retrieves a list of the latest season credits of a TV show.

Credits

This endpoint retrieves the episode groups that have been added to a TV show.

Episode Groups

This endpoint retrieves a list of external Ids that have been added to a TV show.


 The supported external sources include Facebook, IMDB, Instagram,
TheTVDB, Twitter, Wikidata.
    

External IDS

This endpoint retrieves a list of images that belong to a TV series. This includes the backdrops, logos, and posters that have been added to a TV show.

This endpoint retrieves a list of keywords that have been added to a TV show.

This endpoint retrieves a list of the latest TV shows and their Ids.

This endpoint retrieves the list that a TV show has been added to.

This endpoint retrieves a list of recommended TV shows.

This endpoint retrieves a list of reviews that have been added to a TV show.

This endpoint retrieves the seasons and episodes of a TV show that has been screened theatrically.

Screened Theatrically

This endpoint retrieves a list of TV shows that are similar to a particular TV show

This endpoint retrieves a list of translations that have been added to a TV show.

This endpoint retrieves a list of videos that belong to a TV show.

This endpoint retrieves the streaming provider for a TV show.

<Note>
   Important Note


  To use this data, you must attribute the source as **JustWatch.** If we find any usage that does not comply with these terms, we will revoke access to the API.



</Note>

    

Streaming Providers

This endpoint allows you to rate a TV show and save it to your rated list.

<Note>
    Important note

    If the TV show you rated is on your watchlist, it will be automatically removed. This keeps your "watched" and "want to watch" lists tidy and in sync. You can edit this behavior [here](https://www.themoviedb.org/settings/sharing).



</Note>


 

Add Rating

This endpoint allows you to delete a TV show you rated.

Delete Ratings

This endpoint retrieves a list of TV shows airing today.

Airing Today

This endpoint retrieves a list of TV shows that air in the next 7 days.

On The Air

This endpoint retrieves a list of popular TV shows.

This endpoint retrieves a list of all trending TV shows.

This endpoint retrieves the details of a TV season.




          

This endpoint allows you to check if the TV season has been added to your watchlist, favorite, and ratings.

This endpoint retrieves the aggregate credits (acting and crew) that have been added to a TV season.

This endpoint retrieves the recent changes that have been made to a TV season.

<Note>
    Important Note

    You can query this endpoint within the range of 14 days by using `start_date` and `end_date`. If not specified, it retrieves changes that were made in the last 24 hours.



</Note>

    

This endpoint retrieves a list of the latest credits of a TV season.

This endpoint retrieves a list of external Ids that have been added to a TV season.

The supported external sources include TheTVDB and Wikidata.
    

External Ids

This endpoint retrieves a list of images that belong to a TV series.

This endpoint retrieves the translation of a TV season.



 For more information about language onTMB, check the language
documentation [here](https://developer.themoviedb.org/docs/languages).
    

This endpoint retrieves the list of streaming providers for a TV season.

<Note>
   Important Note

    To use this data, you must attribute the source as **JustWatch.** If we find any usage that does not comply with these terms, we will revoke access to the API.



</Note>


    

This endpoint retrieves the details of a TV episode.

The Basics

Using The API

Important IDs

Guides

FAQ