API_KEY

MOVIE_ID

CREDIT_ID

TV_ID

EXTERNAL_ID

PERSON_ID

EXTERNAL_SOURCE

Gain insights into using The Movie Database API in Python to retrieve movie and TV data, including titles, cast, reviews, and create a Django app with integrated TMDB functionalities.

Integrate The Movie Database API in Python.png

TheMovieDB.tar.gz

demo-app

The Movie Database (TMDB) is a popular crowdsourced database for movies and TV shows. TMDB’s API enables us to incorporate functions—usually reserved for leading movie-related websites—into your own application.

This course is a hands-on guide on how to use the TMDB API to programmatically retrieve movie and television show data. You’ll look up essential production data such as title, release date, cast and crew, as well as associated media files like trailer videos and stills. You’ll also pull movie and TV show reviews, and associated productions to make recommendations. With time-bound queries, you’ll be able to display the latest data on movies and TV shows, including upcoming releases. Moreover, you’ll look up actors, directors, producers, and other crew members to find their production catalogs. After reviewing the various potential search functions of the Movie Database API, you’ll wrap up the course by building a Django application that integrates TMDB API.

Integrate The Movie Database API in Python

In this lesson, we’ll focus on how to fetch two main things—details of a person in a TV show or a movie and all the credits for a person in either a TV show or a movie. 

# The details of a person

Like movies and TV shows, we can fetch the details for each person as well. We can use the **person** endpoint to get the basic information about any person. A person can be any cast or crew member of any movie or TV show. This endpoint takes in an integer path parameter `person_id` and returns the details of that person in a single JSON response. 



Here is the base URL in focus:

```
https://api.themoviedb.org/3/person/{person_id}?api_key={ourTMDBapikey}
```

The input query parameters required by this endpoint are as follows:

align-center

The code widget below shows how the basic personal details endpoint works. Before we run our code, please fill in the values for `API_KEY` and `PERSON_ID`. Although you can extract and use all the valid person IDs for your application (check this [lesson](https://www.educative.io/courses/movie-database-api-python/some-useful-ids#Person-IDs)), for now, try some of our suggested movie IDs.

Learn and practice how to fetch the primary details of a person using TMDB API.

Name	Type	Category	Description
`language`	string	optional	This is an `ISO_3166_1` code used to get the translated data as per the specified language. This is applicable to only the fields that support it. The default value is `en-US`.
`append_to_response`	string	optional	This is used to append requests within the same namespace to the response. It follows the pattern ([\w]+).

Object	Type	Category	Description
`adult`	boolean	optional	This is the flag that shows whether or not the person is a part of adult content.
`birthday`	string or null	optional	This returns the date of birth of the person.
`known_for_department`	string	optional	This returns the department name for which the person is famous. For example, Matthew Perry is famous for acting.
`deathday`	null or string	optional	This returns the date of death of the person (only if applicable).
`id`	integer	optional	This is the ID associated with the person on TMDB (it's the same, we pass it as an input parameter).
`name`	string	optional	This is the original name of the person.
`also_known_as`	array[string]	optional	This returns all the names by which the person is commonly known.
`gender`	integer	optional	This returns an integer representing the gender of the person. The value `0` represents not specified, `1` represents female and `2` is for males.
`biography`	string	optional	This returns a few lines or a short paragraph of text that presents a biography of the person.
`popularity`	number	optional	This is the popularity score of the person on TMDB.
`place_of_birth`	string or null	optional	This returns the birthplace of the person.
`profile_path`	string or null	optional	This returns the path to the profile picture of the person.
`imdb_id`	string	optional	This returns the IMDB ID (an external ID) associated with the person on IMDB.
`homepage`	null or string	optional	This returns the URL to the homepage of the person if any.

Introduction

Movies

TV Shows

People

Finding Movies or TV Data

APIs Integration in Django

Conclusion

Appendix

Person Details

The details of a person