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

# Search Shows by title

`GET /shows/search/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.

## Query parameters

- `title` string, required
- `show_type` 'movie' | 'series' — Type of a show.
- `country` string, required
- `series_granularity` 'show' | 'season' | 'episode'
- `output_language` 'en' | 'es' | 'tr' | 'fr'

## Response `200`

Response to a search by title query.

- Show[] — Array of the shows that match the title.
  - `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.

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