Endpoint Playground

Try the JustWatch Discover API

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`.

What a live request returned

14 Oct 2026: 20 results; 10 fields had a value in every checked item.

Observed request: GET /justwatch/discover?country=US&genres=act&language=en&limit=20&monetization_types=FLATRATE&providers=nfx&type=all&year_max=2026&year_min=2020
Fields with a value in every checked item: id, object_id, object_type, title, year, path, url, poster_url

Sample value profiles: object_type: SHOW (11), MOVIE (9); year: 2,020 to 2,026, median 2,023; title: “The Ministry of Ungentlemanly Warfare” and 19 other values.

Request: GET /justwatch/discover
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.87 s
Monitored request: GET /justwatch/discover?country=US&genres=act&language=en&limit=5&monetization_types=FLATRATE&providers=nfx&type=all&year_max=2026&year_min=2020

JustWatch Discover API documentation JustWatch platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/justwatch/discover?country=US&language=en&limit=10&type=movie&monetization_types=FLATRATE" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
country	string	No	US	Two-letter country code
language	string	No	en	Two-letter language code
limit	integer	No	10	Maximum results, defaults to 20 and clamps to 50
type	string	No	movie	Title type: all, movie, show
genres	string	No		Comma-separated JustWatch genre short names
providers	string	No		Comma-separated JustWatch provider short names
production_countries	string	No		Comma-separated two-letter ISO production-country codes
monetization_types	string	No	FLATRATE	Comma-separated monetization types: FLATRATE, FREE, ADS, RENT, BUY
year_min	integer	No		Minimum release year
year_max	integer	No		Maximum release year

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "TW",
    "language": "zh",
    "type": "show",
    "providers": [
      "nfx"
    ],
    "production_countries": [
      "KR"
    ],
    "results": [
      {
        "id": "ts287292",
        "object_type": "SHOW",
        "title": "魷魚遊戲",
        "year": 2021,
        "path": "/tw/tv-show/squid-game",
        "production_countries": [
          "KR"
        ]
      }
    ]
  }
}

More JustWatch endpoints

Get JustWatch age certifications Get JustWatch episode by raw id Get JustWatch episode offers Get JustWatch genre titles Get JustWatch genres Get JustWatch monetization titles Get new JustWatch titles Get popular JustWatch titles Get JustWatch provider titles Get JustWatch providers Search JustWatch titles Get JustWatch season by raw id All 21 JustWatch endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestjustwatch.discoverResponseDocJustWatch

GET /justwatch/discover

Discover JustWatch titles

Response behavior

- Invalid `country`, `language`, `type`, `genres`, `providers`, `production_countries`, `monetization_types`, `year_min`, or `year_max` values return `400`. - `production_countries` filters on the title's country of origin (JustWatch popularity within a `country` market), not the market itself. Use `country` for the market and `production_countries` for the origin. - Each result carries a `production_countries` array so callers can confirm the origin used for the filter. - Upstream errors or unexpected empty discover responses return `503`. - Provider short names can be discovered with `/api/v1/justwatch/providers`; genre short names can be discovered with `/api/v1/justwatch/genres`.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "TW",
    "language": "zh",
    "type": "show",
    "providers": [
      "nfx"
    ],
    "production_countries": [
      "KR"
    ],
    "results": [
      {
        "id": "ts287292",
        "object_type": "SHOW",
        "title": "魷魚遊戲",
        "year": 2021,
        "path": "/tw/tv-show/squid-game",
        "production_countries": [
          "KR"
        ]
      }
    ]
  }
}

Endpoint Playground

Try the JustWatch Discover API

What a live request returned

14 Oct 2026: 20 results; 10 fields had a value in every checked item.

Observed request: GET /justwatch/discover?country=US&genres=act&language=en&limit=20&monetization_types=FLATRATE&providers=nfx&type=all&year_max=2026&year_min=2020
Fields with a value in every checked item: id, object_id, object_type, title, year, path, url, poster_url

Sample value profiles: object_type: SHOW (11), MOVIE (9); year: 2,020 to 2,026, median 2,023; title: “The Ministry of Ungentlemanly Warfare” and 19 other values.

Request: GET /justwatch/discover
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.87 s
Monitored request: GET /justwatch/discover?country=US&genres=act&language=en&limit=5&monetization_types=FLATRATE&providers=nfx&type=all&year_max=2026&year_min=2020

JustWatch Discover API documentation JustWatch platform page Pricing

Prefilled cURL

curl "https://api.crawlora.net/api/v1/justwatch/discover?country=US&language=en&limit=10&type=movie&monetization_types=FLATRATE" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
country	string	No	US	Two-letter country code
language	string	No	en	Two-letter language code
limit	integer	No	10	Maximum results, defaults to 20 and clamps to 50
type	string	No	movie	Title type: all, movie, show
genres	string	No		Comma-separated JustWatch genre short names
providers	string	No		Comma-separated JustWatch provider short names
production_countries	string	No		Comma-separated two-letter ISO production-country codes
monetization_types	string	No	FLATRATE	Comma-separated monetization types: FLATRATE, FREE, ADS, RENT, BUY
year_min	integer	No		Minimum release year
year_max	integer	No		Maximum release year

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "TW",
    "language": "zh",
    "type": "show",
    "providers": [
      "nfx"
    ],
    "production_countries": [
      "KR"
    ],
    "results": [
      {
        "id": "ts287292",
        "object_type": "SHOW",
        "title": "魷魚遊戲",
        "year": 2021,
        "path": "/tw/tv-show/squid-game",
        "production_countries": [
          "KR"
        ]
      }
    ]
  }
}

More JustWatch endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestjustwatch.discoverResponseDocJustWatch

GET /justwatch/discover

Discover JustWatch titles

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "TW",
    "language": "zh",
    "type": "show",
    "providers": [
      "nfx"
    ],
    "production_countries": [
      "KR"
    ],
    "results": [
      {
        "id": "ts287292",
        "object_type": "SHOW",
        "title": "魷魚遊戲",
        "year": 2021,
        "path": "/tw/tv-show/squid-game",
        "production_countries": [
          "KR"
        ]
      }
    ]
  }
}