Sign in

v1

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

Get Top Shows

Get the official top shows in a service. Top shows are determined by the streaming service itself.

Supported streaming services are:

  • Netflix: netflix
  • Amazon Prime Video: prime
  • Apple TV: apple
  • Max: hbo

For unsupported services, this endpoint will return an empty list.

Series granularity is always show for this endpoint, meaning that the output will not include season and episode info.

get/shows/top

Query parameters

countrystring required

ISO 3166-1 alpha-2 code of the target country. See /countries endpoint to get the list of supported countries.

servicestring required

Id of the target service.

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

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

show_type'movie' | 'series'

Type of a show.

Type of shows to search in. If not supplied, both movies and series will be included in the search results.

Response

Response to a top shows query.

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"
  }
]