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.

Show

interface Show {
    cast: string[];
    creators?: string[];
    directors?: string[];
    episodeCount?: number;
    firstAirYear?: number;
    genres: Genre[];
    id: string;
    imageSet: ShowImageSet;
    imdbId: string;
    itemType: string;
    lastAirYear?: number;
    originalTitle: string;
    overview: string;
    rating: number;
    releaseYear?: number;
    runtime?: number;
    seasonCount?: number;
    seasons?: Season[];
    showType: ShowType;
    streamingOptions: {
        [key: string]: StreamingOption[];
    };
    title: string;
    tmdbId: string;
}

Properties

cast: string[]

Array of the cast of the show.

Show

creators?: string[]

Array of the creators of the series.

Show

directors?: string[]

Array of the directors of the movie.

Show

episodeCount?: number

Number of episodes that are either aired or announced for a series.

Show

firstAirYear?: number

The first year that the series aired.

Show

genres: Genre[]

Array of the genres of the show.

Show

id: string

Id of the show.

Show

imageSet: ShowImageSet

Image set of the show.

Show

imdbId: string

IMDb id of the show.

Show

itemType: string

Type of the item. Always show.

Show

lastAirYear?: number

The last year that the series aired.

Show

originalTitle: string

Original title of the show.

Show

overview: string

A brief overview of the overall plot of the show.

Show

rating: number

Rating of the show. This is calculated by taking the average of ratings found online from multiple sources.

Show

releaseYear?: number

The year that the movie was released.

Show

runtime?: number

Runtime of the movie in minutes.

Show

seasonCount?: number

Number of seasons that are either aired or announced for a series.

Show

seasons?: Season[]

Array of the seasons belong to the series.

Show

showType: ShowType

Type of the show. Based on the type, some properties might be omitted.

Show

streamingOptions: {
    [key: string]: StreamingOption[];
}

Map of the streaming options by the country code.

Show

title: string

Title of the show.

Show

tmdbId: string

TMDB id of the show.

Show