JustWatch

Discover JustWatch titles

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.

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

Query parameters

countrystring

Two-letter country code

languagestring

Two-letter language code

limitinteger

Maximum results, defaults to 20 and clamps to 50

type'all' | 'movie' | 'show'

Title type: all, movie, show

genresstring

Comma-separated JustWatch genre short names

providersstring

Comma-separated JustWatch provider short names

production_countriesstring

Comma-separated two-letter ISO production-country codes

monetization_types'FLATRATE' | 'FREE' | 'ADS' | 'RENT' | 'BUY'

Comma-separated monetization types: FLATRATE, FREE, ADS, RENT, BUY

year_mininteger

Minimum release year

year_maxinteger

Maximum release year

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "country": "US",
    "genres": [
      "act"
    ],
    "language": "en",
    "monetization_types": [
      "FLATRATE"
    ],
    "production_countries": [
      "KR"
    ],
    "providers": [
      "nfx"
    ],
    "results": [
      {
        "id": "tm92641",
        "object_id": 92641,
        "object_type": "MOVIE",
        "offers": [
          {
            "availability": "https://schema.org/InStock",
            "category": "Blu-Ray",
            "currency": "USD",
            "monetization_type": "RENT",
            "presentation_type": "4K",
            "price": 4.99,
            "provider": "Amazon Video",
            "provider_id": 10,
            "provider_short": "amz",
            "provider_technical": "amazon"
          }
        ],
        "path": "/us/movie/inception",
        "poster_url": "https://images.justwatch.com/poster/302449148/s718/inception.jpg",
        "production_countries": [
          "KR"
        ],
        "title": "Inception",
        "url": "https://www.justwatch.com/us/movie/inception",
        "year": 2010
      }
    ],
    "type": "all",
    "year_max": 2026,
    "year_min": 2020
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.