--- title: "Get a Show" method: GET path: "/shows/{id}" tags: ["shows"] --- # Get a Show `GET /shows/{id}` Get the details of a show via id, imdbId or tmdbId, including the global streaming availability info. ## Path parameters - `id` string, required ## Query parameters - `country` string - `series_granularity` 'show' | 'season' | 'episode' - `output_language` 'en' | 'es' | 'tr' | 'fr' ## Response `200` Details of the show. - 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}](#get-a-show) endpoint; you can search shows by their title via [/shows/search/title](#search-shows-by-title) endpoint; and you can search shows by filters such as genres, release year, rating etc. via [/shows/search/filters](#search-shows-by-filters) endpoint. This endpoint also supports pagination and offers advanced ordering options such as ordering by popularity, rating, release year etc. - `itemType` 'show', required — Type of the item. Always show. - `showType` 'movie' | 'series', required — Type of a show. - `id` string, required — Id of the show. - `imdbId` string, required — [IMDb](https://www.imdb.com/) id of the show. - `tmdbId` string, required — [TMDB](https://www.themoviedb.org/) id of the show. - `title` string, required — Title of the show. - `overview` string, required — A brief overview of the overall plot of the show. - `releaseYear` integer — The year that the movie was released. - `firstAirYear` integer — The first year that the series aired. - `lastAirYear` integer — The last year that the series aired. - `originalTitle` string, required — Original title of the show. - `genres` Genre[], required — Array of the genres of the show. - `id` string, required — Id of a genre. - `name` string, required — Name of the genre - `directors` string[] — Array of the directors of the movie. - `creators` string[] — Array of the creators of the series. - `cast` string[], required — Array of the cast of the show. - `rating` integer, required — Rating of the show. This is calculated by taking the average of ratings found online from multiple sources. - `seasonCount` integer — Number of seasons that are either aired or announced for a series. - `episodeCount` integer — Number of episodes that are either aired or announced for a series. - `runtime` integer — Runtime of the movie in minutes. - `imageSet` ShowImageSet, required — Image set of a show. - `verticalPoster` VerticalImage, required — Horizontal image of a show. - `w240` string, required — Link to the 240px wide version of the image. - `w360` string, required — Link to the 360px wide version of the image. - `w480` string, required — Link to the 480px wide version of the image. - `w600` string, required — Link to the 600px wide version of the image. - `w720` string, required — Link to the 720px wide version of the image. - `horizontalPoster` HorizontalImage, required — Horizontal image of a show. - `w360` string, required — Link to the 360px wide version of the image. - `w480` string, required — Link to the 480px wide version of the image. - `w720` string, required — Link to the 720px wide version of the image. - `w1080` string, required — Link to the 1080px wide version of the image. - `w1440` string, required — Link to the 1440px wide version of the image. - `verticalBackdrop` VerticalImage — Horizontal image of a show. - `w240` string, required — Link to the 240px wide version of the image. - `w360` string, required — Link to the 360px wide version of the image. - `w480` string, required — Link to the 480px wide version of the image. - `w600` string, required — Link to the 600px wide version of the image. - `w720` string, required — Link to the 720px wide version of the image. - `horizontalBackdrop` HorizontalImage — Horizontal image of a show. - `w360` string, required — Link to the 360px wide version of the image. - `w480` string, required — Link to the 480px wide version of the image. - `w720` string, required — Link to the 720px wide version of the image. - `w1080` string, required — Link to the 1080px wide version of the image. - `w1440` string, required — Link to the 1440px wide version of the image. - `streamingOptions` StreamingOptionsMap, required — Map of the streaming options by the country code. - `seasons` Season[] — Array of the seasons belong to the series. - `itemType` 'season', required — Type of the item. Always season. - `title` string, required — Title of the season. - `firstAirYear` integer, required — The first year that the season aired. - `lastAirYear` integer, required — The last year that the season aired. - `streamingOptions` StreamingOptionsMap, required — Map of the streaming options by the country code. - `episodes` Episode[] — Array of the episodes belong to the season. - `itemType` 'episode', required — Type of the item. Always episode. - `title` string, required — Title of the episode. - `overview` string — A brief overview of the plot of the episode. - `airYear` integer, required — The year that the episode aired. - `streamingOptions` StreamingOptionsMap, required — Map of the streaming options by the country code. ## Other responses - `404` — The show is not found. - `default` — An error occurred. --- [API](https://skmtc.net/myangel-ai/apis/streaming-availability-api.md) · [All operations](https://skmtc.net/myangel-ai/apis/streaming-availability-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myangel-ai/streaming-availability-api/versions/16fa35a29f15/schema)