---
title: "Get JustWatch episode offers"
method: GET
path: "/justwatch/episode/offers"
tags: ["JustWatch"]
---

# Get JustWatch episode offers

`GET /justwatch/episode/offers`

## Request

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

Returns the streaming offers for one JustWatch episode `id` (`tse` followed by digits) across one to five comma-separated country codes in `countries` (default `US`), with `language` defaulting to `en`. Each country entry lists offers by provider, monetization type, presentation type, price and currency, with the episode details. An unknown id returns `404`.

## Query parameters

- `id` string, required
- `countries` string
- `language` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JustwatchEpisodeOffersResponseDoc
  - `code` integer
  - `data` JustwatchEpisodeOffersResponse
    - `countries` JustwatchEpisodeCountryOffers[]: Offers for the episode, one item per country.
      - `country` string: Two-letter ISO country code the offers apply to.
      - `episode` JustwatchEpisodeSummary
        - `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.
      - `offers` JustwatchOffer[]: Offers for the episode in this country.
        - `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.
    - `id` string: JustWatch episode id the offers belong to, for example `tse5550494`.
    - `language` string: Two-letter language code used for titles and descriptions.
  - `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)