Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2024-10-3183068.7 KB
shows

Get a Show

Get the details of a show via id, imdbId or tmdbId, including the global streaming availability info.

get/shows/{id}

Path parameters

idstring required

id of the show. You can also pass an IMDb Id or a TMDB Id as an id. The endpoint will automatically detect the type of the id and fetch the show accordingly.

When passing an IMDb Id, it should be in the format of tt<numerical_id>. (e.g. tt0120338 for Titanic)

When passing a TMDB Id, it should be in the format of movie/<numerical_id> for movies and tv/<numerical_id> for series. (e.g. tv/1396 for Breaking Bad and movie/597 for Titanic)

Query parameters

countrystring

ISO 3166-1 alpha-2 code of the optional target country. If this parameter is not supplied, global streaming availability across all the countries will be returned. If it is supplied, only the streaming availability info from the given country will be returned. If you are only interested in the streaming availability in a single country, then it is recommended to use this parameter to reduce the size of the response and increase the performance of the endpoint. See /countries endpoint to get the list of supported countries.

series_granularity'show' | 'season' | 'episode'

series_granularity determines the level of detail for series. It does not affect movies.

If series_granularity is show, then the output will not include season and episode info.

If series_granularity is season, then the output will include season info but not episode info.

If series_granularity is episode, then the output will include season and episode info.

If you do not need season and episode info, then it is recommended to set series_granularity as show to reduce the size of the response and increase the performance of the endpoint.

If you need deep links for individual seasons and episodes, then you should set series_granularity as episode. In this case response will include full streaming info for seasons and episodes, similar to the streaming info for movies and series; including deep links into seasons and episodes, individual subtitle/audio and video quality info etc.

output_language'en' | 'es' | 'tr' | 'fr'

ISO 639-1 code of the output language. Determines in which language the output will be in.

Response

Details of the show.

itemType'show' required

Type of the item. Always show.

showType'movie' | 'series' required

Type of a show.

idstring required

Id of the show.

imdbIdstring required

IMDb id of the show.

tmdbIdstring required

TMDB id of the show.

titlestring required

Title of the show.

overviewstring required

A brief overview of the overall plot of the show.

releaseYearinteger

The year that the movie was released.

firstAirYearinteger

The first year that the series aired.

lastAirYearinteger

The last year that the series aired.

originalTitlestring required

Original title of the show.

directorsstring[]

Array of the directors of the movie.

creatorsstring[]

Array of the creators of the series.

caststring[] required

Array of the cast of the show.

ratinginteger required

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

seasonCountinteger

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

episodeCountinteger

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

runtimeinteger

Runtime of the movie in minutes.

streamingOptionsStreamingOptionsMap required

Map of the streaming options by the country code.

Example response

{
  "summary": "The Godfather",
  "externalValue": "https://www.movieofthenight.com/v4/examples/shows/god-father"
}