Array of the cast of the show.
Optional
creatorsArray of the creators of the series.
Optional
directorsArray of the directors of the movie.
Optional
episodeNumber of episodes that are either aired or announced for a series.
Optional
firstThe first year that the series aired.
Array of the genres of the show.
Id of the show.
Image set of the show.
IMDb id of the show.
Type of the item. Always show.
Optional
lastThe last year that the series aired.
Original title of the show.
A brief overview of the overall plot of the show.
Rating of the show. This is calculated by taking the average of ratings found online from multiple sources.
Optional
releaseThe year that the movie was released.
Optional
runtimeRuntime of the movie in minutes.
Optional
seasonNumber of seasons that are either aired or announced for a series.
Optional
seasonsArray of the seasons belong to the series.
Type of the show. Based on the type, some properties might be omitted.
Map of the streaming options by the country code.
Title of the show.
TMDB id of the show.
A show object represents a movie or a series. Type of the show is determined by the showType property, which is either movie or series. Based on this type, some properties are omitted, for example a movie does not have seasonCount and episodeCount properties.
Show object contains the details such as the title, overview, genres, cast, rating and images. You can find the streaming availability information under streamingOptions property. Each streaming option contains the service info, deep link, video quality, available audios and subtitles and more. It also includes the price if the show is available to buy or rent; and addon info if the show is available via an addon (such as Apple TV Channels, Prime Video Channels etc.).
You can also find the seasons of the series under the seasons property, and the episodes of a season under the episodes property of the season object. Via the streamingOptions property of seasons and episodes, you can get the individual streaming options of them. These streaming options include the same set of properties as the show streaming options, so you can use them to get deep links to episodes and seasons, and to see available audios and subtitles.
Note that seasons and episodes are not included in the search results unless you set the series_granularity parameter to seasons or episodes. For more info, check out the series_granularity parameter of the search endpoints.
There are multiple ways to retrieve shows. You can retrieve a show by its IMDb or TMDB id via /shows/{id} endpoint; you can search shows by their title via /shows/search/title endpoint; and you can search shows by filters such as genres, release year, rating etc. via /shows/search/filters endpoint. This endpoint also supports pagination and offers advanced ordering options such as ordering by popularity, rating, release year etc.
Export
Show