Hit TV Shows
Learn and practice how to get popular, top-rated, and trending TV shows using TMDB API.
We'll cover the following...
This lesson focuses on a few methods that will allow us to get some hit shows on TMDB.
Popular TV shows
The popularity of any TV show is calculated based on factors like user votes, the number of user visits to the show’s homepage, how many times the video of any episode was played, and so on. The popular TV shows endpoint helps us get a list of the currently popular TV shows on TMDB. This list updates daily on the platform. The endpoint doesn’t take any path parameters.
The base URL in focus is as follows:
https://api.themoviedb.org/3/tv/popular?api_key={ourTMDBapikey}
The input query parameters required by this endpoint are as follows:
Name | Type | Category | Description |
| string | optional | This is an |
| integer | optional | This is used to specify which page to query. Its value can be in the range of 1–1000 inclusive. The default value is |
The objects in the output JSON response are as follows:
Object | Type | Category | Description |
| integer | optional | This is the page being queried. |
| array[object] | optional | This returns all the popular TV shows (with their details) on the specified page, such as 21 shows on page 1, then 20 shows on page 2, and so on. |
| integer | optional | This is the total number of pages having popular TV shows on TMDB. |
| integer | optional | This is the total number of popular TV shows on TMDB. |
Let’s run ...