---
title: "Get Top Shows"
method: GET
path: "/shows/top"
tags: ["shows"]
---

# Get Top Shows

`GET /shows/top`

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.

## Query parameters

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

## Response `200`

Response to a top shows query.

- Show[] — Array of the top 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.

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