---
title: "Discover JustWatch titles"
method: GET
path: "/justwatch/discover"
tags: ["JustWatch"]
---

# Discover JustWatch titles

`GET /justwatch/discover`

## Request

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

Returns popular movies and shows filtered by optional genre short names, provider short names, production countries, monetization types, and release year bounds. Combine `providers` with `production_countries` to build charts such as most popular Korean or Japanese titles on a given service. Type accepts only `all`, `movie`, or `show`; monetization_types accepts only `FLATRATE`, `FREE`, `ADS`, `RENT`, or `BUY`.

## Query parameters

- `country` string
- `language` string
- `limit` integer
- `type` 'all' | 'movie' | 'show'
- `genres` string
- `providers` string
- `production_countries` string
- `monetization_types` 'FLATRATE' | 'FREE' | 'ADS' | 'RENT' | 'BUY'
- `year_min` integer
- `year_max` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JustwatchDiscoverResponseDoc
  - `code` integer
  - `data` JustwatchDiscoverResponse
    - `country` string: Two-letter ISO country code the results are for.
    - `genres` string[]: Genre short names that were used as filters.
    - `language` string: Two-letter language code used for titles and descriptions.
    - `monetization_types` string[]: Monetization types that were used as filters, for example `FLATRATE`.
    - `production_countries` string[]: Production country codes that were used as filters.
    - `providers` string[]: Provider short names that were used as filters, for example `nfx`.
    - `results` JustwatchSearchTitle[]: Titles matching the request, one item per title.
      - `id` string: JustWatch title id, for example `tm92641` for a movie.
      - `object_id` integer: Numeric JustWatch id of the title.
      - `object_type` string: JustWatch object type of the title, for example `MOVIE` or `SHOW`.
      - `offers` JustwatchOffer[]: Streaming, rental and purchase offers for the title.
        - `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 title, for example `/us/movie/inception`.
      - `poster_url` string: URL of the poster image for the title.
      - `production_countries` string[]: ProductionCountries lists the title's country of origin as two-letter ISO codes. It is only populated on surfaces that request it, such as discover.
      - `title` string: Name of the title in the requested language.
      - `url` string: Full JustWatch page URL of the title.
      - `year` integer: Release year of the title.
    - `type` string: Content type filter applied: `all`, `movie` or `show`.
    - `year_max` integer: Latest release year used as a filter.
    - `year_min` integer: Earliest release year used as a filter.
  - `msg` string

## Other responses

- `400`: Bad Request
- `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)