---
title: "Get JustWatch season episodes"
method: GET
path: "/justwatch/season/episodes"
tags: ["JustWatch"]
---

# Get JustWatch season episodes

`GET /justwatch/season/episodes`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/justwatch/season/episodes`
- Auth: API key in header `x-api-key`

Lists the episodes of a JustWatch season given as `season_id` (`tss` followed by digits), with `country` defaulting to `US` and `language` to `en`. Each episode has its number, title, description and streaming offers with provider, price and currency. Path, URL and poster appear only when JustWatch has them for that episode. An unknown season returns `404`.

## Query parameters

- `season_id` string, required
- `country` string
- `language` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JustwatchSeasonEpisodesResponseDoc
  - `code` integer
  - `data` JustwatchSeasonEpisodesResponse
    - `country` string: Two-letter ISO country code the results are for.
    - `episodes` JustwatchEpisodeSummary[]: Episodes of the season, in order.
      - `description` string: Short synopsis of the episode.
      - `episode_number` integer: Number of the episode within its season.
      - `id` string: JustWatch episode id, for example `tse5550494`.
      - `object_id` integer: Numeric JustWatch id of the episode.
      - `object_type` string: JustWatch object type, `SHOW_EPISODE` for episodes.
      - `offers` JustwatchOffer[]: Offers for the episode, when requested.
        - `availability` string: Availability of the offer as a schema.org URL, for example `https://schema.org/InStock`.
        - `category` string: Format label shown for the offer, for example `Blu-Ray`.
        - `currency` string: Currency of `price`, as an ISO 4217 code such as `USD`.
        - `monetization_type` string: How the title is offered: `FLATRATE`, `FREE`, `ADS`, `RENT` or `BUY`.
        - `presentation_type` string: Picture format of the offer, for example `HD` or `4K`.
        - `price` number: Price of the offer in `currency`. Omitted for free and subscription offers without a price.
        - `provider` string: Name of the provider offering the title, for example `Amazon Video`.
        - `provider_id` integer: JustWatch id of the provider.
        - `provider_short` string: Short provider code, for example `amz`.
        - `provider_technical` string: Technical provider name used by JustWatch, for example `amazon`.
        - `url` string: Link to watch or buy the title at the provider.
      - `path` string: JustWatch page path of the episode.
      - `poster_url` string: URL of the still or poster image for the episode.
      - `title` string: Episode title in the requested language.
      - `url` string: Full JustWatch page URL of the episode.
      - `year` integer: Release year of the episode.
    - `language` string: Two-letter language code used for titles and descriptions.
    - `season` JustwatchSeasonSummary
      - `description` string: Short synopsis of the season.
      - `id` string: JustWatch season id, for example `tss297253`.
      - `object_id` integer: Numeric JustWatch id of the season.
      - `object_type` string: JustWatch object type, `SHOW_SEASON` for seasons.
      - `path` string: JustWatch page path of the season.
      - `poster_url` string: URL of the poster image for the season.
      - `season_number` integer: Number of the season within the show.
      - `title` string: Season title, for example `Season 1`.
      - `url` string: Full JustWatch page URL of the season.
      - `year` integer: Release year of the season.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)