Sign in

v1

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

Search Shows by title

Search for movies and series by a title. Maximum amount of items returned are 20 unless there are more than 20 shows with the exact given title input. In that case all the items have 100% match with the title will be returned.

Streaming availability info for the target country is included in the response, but not for the other countries.

Results might include shows that are not streamable in the target country. Only criteria for the search are the title and the show type.

No pagination is supported.

get/shows/search/title

Query parameters

titlestring required

Title phrase to search for.

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.

countrystring required

ISO 3166-1 alpha-2 code of the target country. 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

Response to a search by title 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"
  }
]