Streav
Streav

GET /v1/shows

Retrieves a paginated list of shows.

Parameters
NameLocated inDescriptionRequiredType
TitlequeryOptional. Filter movies by title.Nostring
GenreIdqueryOptional. Filter movies by a list of genre IDs.No integer
BundleIdqueryOptional. Filter movies associated with a specific bundle ID.Nointeger
LanguageCodequeryOptional. Filter movies by language. Use ISO 639-1 language codes (e.g., 'en' for English).Nostring
CountryCodequeryOptional. Filter movies by country of origin using ISO 3166-1 alpha-2 country codes (e.g., 'US' for United States).Nostring
SortByqueryOptional. Sort movies by specified field. Use 'title' for ascending or 'title_desc' for descending order by title. Use 'releaseDate' or 'releaseDate_desc' for sorting by release date. Use 'rating' or 'rating_desc' for sorting by rating. Defaults to ascending order by ID if not specified.Nostring
IncludequeryOptional. The related data to include. Possible values are genres and casts.No string
PagequeryPage number to retrieve. Default is 1.Nointeger
PageSizequeryNumber of records per page. Default is 25.Nointeger
Responses
CodeDescription
200Success

GET /v1/shows/{id}

Retrieves a show by ID.

Parameters
NameLocated inDescriptionRequiredType
idpathThe ID of the show to retrieve.Yesinteger
includequeryThe related data to include. Possible values are genres and casts.No string
Responses
CodeDescription
200Success
422Validation error if the input parameters are incorrect.

GET /v1/shows/{id}/seasons

Retrieves paginated seasons of a show by its ID.

Parameters
NameLocated inDescriptionRequiredType
idpathThe ID of the show for which to retrieve seasons.Yesinteger
sortByqueryOptional. Specifies the sort order of the seasons. Use 'name' for ascending order by season name, 'name_desc' for descending order by season name, 'releaseDate' for ascending order by season release date, 'releaseDate_desc' for descending order by season release date. Defaults to ascending order by season number if not specified.Nostring
PagequeryPage number to retrieve. Default is 1.Nointeger
PageSizequeryNumber of records per page. Default is 25.Nointeger
Responses
CodeDescription
200Success

GET /v1/shows/{id}/seasons/{number}

Retrieves paginated episodes of a specific season of a show by its ID and season number.

Parameters
NameLocated inDescriptionRequiredType
idpathThe ID of the show for which to retrieve episodes.Yesinteger
numberpathThe season number for which to retrieve episodes.Yesinteger
sortByqueryOptional. Specifies the sort order of the episodes. Use 'name' for ascending order by episode name, 'name_desc' for descending order by episode name, 'releaseDate' for ascending order by episode release date, 'releaseDate_desc' for descending order by episode release date. Defaults to ascending order by episode number if not specified.Nostring
PagequeryPage number to retrieve. Default is 1.Nointeger
PageSizequeryNumber of records per page. Default is 25.Nointeger
Responses
CodeDescription
200Success