---
title: "Search Shows by filters"
method: GET
path: "/shows/search/filters"
tags: ["shows"]
---

# Search Shows by filters

`GET /shows/search/filters`

Search through the catalog of the given streaming services in the given country.
Provides filters such as show language, genres, keyword and release year.
Output includes all the information about the shows,
such as title, IMDb ID, TMDb ID, release year,
deep links to streaming services,
available subtitles, audios, available video quality
and many more!
Apart from the info about the given country-service combinations,
output also includes information about streaming availability in the other services for the given country.
Streaming availability info from the other countries are not included in the response.

When show_type is movie or series_granularity is show, items per page is 20.
When show_type is series and series_granularity is episode items per page is 10.
Otherwise, items per page is 15.

## Query parameters

- `country` string, required
- `catalogs` string[]
- `output_language` 'en' | 'es' | 'tr' | 'fr'
- `show_type` 'movie' | 'series' — Type of a show.
- `genres` GenreId[]
- `genres_relation` 'and' | 'or'
- `show_original_language` string
- `year_min` integer
- `year_max` integer
- `rating_min` integer
- `rating_max` integer
- `keyword` string
- `series_granularity` 'show' | 'season' | 'episode'
- `order_by` 'original_title' | 'release_date' | 'rating' | 'popularity_alltime' | 'popularity_1year' | 'popularity_1month' | 'popularity_1week'
- `order_direction` 'asc' | 'desc'
- `cursor` string

## Response `200`

Response to a search by filters query.

- SearchResult
  - `shows` Show[], required — Array of shows.
    - `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.
  - `hasMore` boolean, required — Whether there are more shows available.
  - `nextCursor` string — Cursor value to pass to get the next set of shows.

## Other responses

- `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)