# JustWatch API — where to watch any movie or TV show in 139 countries: streaming, rent and buy offers with prices and quality, JustWatch charts, trending, new and leaving titles, cast, people, providers and plans

> Search movies and TV shows by name (JustWatch's own search), with every title filter, sort and where-to-watch offers per row.
> ReefAPI engine `justwatch` · 25 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/justwatch/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/justwatch/v1/search — 1 credit
Search movies and TV shows by name (JustWatch's own search), with every title filter, sort and where-to-watch offers per row.

**Parameters:**
- `query` (string, required) — Words to search for.
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `genres` (array, optional) — Genres by short name (act, cmy, drm, hrr …) or name ('Action', 'Comedy') — see `genres`.
- `exclude_genres` (array, optional) — Genres to leave out (same values as `genres`).
- `subgenres` (array, optional) — JustWatch sub-genre short names (see `genres` → subgenres), e.g. 'superhero-movies'.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `age_certifications` (array, optional) — Age ratings as the market prints them (US: G, PG, PG-13, R, NC-17; GB: U, PG, 12, 15, 18 …) — see `age_ratings`.
- `production_countries` (array, optional) — Only titles produced in these countries (ISO-2).
- `exclude_production_countries` (array, optional) — Leave out titles produced in these countries (ISO-2).
- `year_min` (integer, optional) — Earliest release year.
- `year_max` (integer, optional) — Latest release year.
- `imdb_score_min` (number, optional) — Minimum IMDb score (0-10).
- `imdb_score_max` (number, optional) — Maximum IMDb score (0-10).
- `imdb_votes_min` (integer, optional) — Minimum number of IMDb votes.
- `tomato_meter_min` (integer, optional) — Minimum Rotten Tomatoes Tomatometer (0-100).
- `runtime_min` (integer, optional) — Minimum runtime in minutes.
- `runtime_max` (integer, optional) — Maximum runtime in minutes.
- `price_min` (number, optional) — Minimum offer price in the market's currency (rent/buy offers).
- `price_max` (number, optional) — Maximum offer price in the market's currency (rent/buy offers).
- `include_titles_without_page` (boolean, optional, default false) — Also list titles JustWatch has no page for (its full catalogue: 3.3 M US titles vs 206 k with pages).
- `sort_by` (enum, optional, default "popular") — Ranking: popular (30-day popularity, the site default), trending (7-day), popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year (newest first), alphabetical, runtime, random (search also: relevance). alphabetical follows JustWatch's own sort key (titles starting with punctuation come first). Lists sorted this way stop at row 1,999. [one of: popular, trending, popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year, alphabetical, runtime, random, relevance]
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `offers` (enum, optional, default "best") — Offers per row: best = one per provider and payment type, as justwatch.com lists them (default) · all = every quality and disc offer · none = no offers (smallest rows). [one of: best, all, none]
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{id, object_type, title, original_title, year, release_date, url, description, runtime_minutes, age_certification, production_countries, genres, genre_names, imdb_id, tmdb_id, scoring{imdb_score, imdb_votes, tmdb_score, tmdb_popularity, jw_rating, jw_rating_percent, tomato_meter, certified_fresh}, likes, dislikes, votes, poster_url, popularity_rank{rank, trend, trend_difference}, offer_count, offers[]{provider, provider_id, provider_short_name, type, quality, price (as printed), price_printed_value, price_value (JustWatch's numeric field, can be 0.01 under the printed price), currency, previous_price_value, url, available_to, element_count, …}}, total, has_more, next_cursor

**Example request body:**
```json
{
  "query": "Inception",
  "country": "US",
  "page_size": 5
}
```

### POST https://api.reefapi.com/justwatch/v1/browse — 1 credit
Browse a market's catalogue (justwatch.com's movies / TV shows pages) with every filter the site offers — providers, genres, sub-genres, type, payment type, quality, age rating, production country, year, IMDb score/votes, Tomatometer, runtime, price — and every sort.

**Parameters:**
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `genres` (array, optional) — Genres by short name (act, cmy, drm, hrr …) or name ('Action', 'Comedy') — see `genres`.
- `exclude_genres` (array, optional) — Genres to leave out (same values as `genres`).
- `subgenres` (array, optional) — JustWatch sub-genre short names (see `genres` → subgenres), e.g. 'superhero-movies'.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `age_certifications` (array, optional) — Age ratings as the market prints them (US: G, PG, PG-13, R, NC-17; GB: U, PG, 12, 15, 18 …) — see `age_ratings`.
- `production_countries` (array, optional) — Only titles produced in these countries (ISO-2).
- `exclude_production_countries` (array, optional) — Leave out titles produced in these countries (ISO-2).
- `year_min` (integer, optional) — Earliest release year.
- `year_max` (integer, optional) — Latest release year.
- `imdb_score_min` (number, optional) — Minimum IMDb score (0-10).
- `imdb_score_max` (number, optional) — Maximum IMDb score (0-10).
- `imdb_votes_min` (integer, optional) — Minimum number of IMDb votes.
- `tomato_meter_min` (integer, optional) — Minimum Rotten Tomatoes Tomatometer (0-100).
- `runtime_min` (integer, optional) — Minimum runtime in minutes.
- `runtime_max` (integer, optional) — Maximum runtime in minutes.
- `price_min` (number, optional) — Minimum offer price in the market's currency (rent/buy offers).
- `price_max` (number, optional) — Maximum offer price in the market's currency (rent/buy offers).
- `include_titles_without_page` (boolean, optional, default false) — Also list titles JustWatch has no page for (its full catalogue: 3.3 M US titles vs 206 k with pages).
- `sort_by` (enum, optional, default "popular") — Ranking: popular (30-day popularity, the site default), trending (7-day), popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year (newest first), alphabetical, runtime, random (search also: relevance). alphabetical follows JustWatch's own sort key (titles starting with punctuation come first). Lists sorted this way stop at row 1,999. [one of: popular, trending, popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year, alphabetical, runtime, random, relevance]
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `offers` (enum, optional, default "best") — Offers per row: best = one per provider and payment type, as justwatch.com lists them (default) · all = every quality and disc offer · none = no offers (smallest rows). [one of: best, all, none]
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{id, object_type, title, original_title, year, release_date, url, description, runtime_minutes, age_certification, production_countries, genres, genre_names, imdb_id, tmdb_id, scoring{imdb_score, imdb_votes, tmdb_score, tmdb_popularity, jw_rating, jw_rating_percent, tomato_meter, certified_fresh}, likes, dislikes, votes, poster_url, popularity_rank{rank, trend, trend_difference}, offer_count, offers[]{provider, provider_id, provider_short_name, type, quality, price (as printed), price_printed_value, price_value (JustWatch's numeric field, can be 0.01 under the printed price), currency, previous_price_value, url, available_to, element_count, …}}, total, has_more, next_cursor

**Example request body:**
```json
{
  "object_types": [
    "movie"
  ]
}
```

### POST https://api.reefapi.com/justwatch/v1/trending — 1 credit
What is trending on JustWatch right now (7-day popularity), with offers; same filters as browse.

**Parameters:**
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `genres` (array, optional) — Genres by short name (act, cmy, drm, hrr …) or name ('Action', 'Comedy') — see `genres`.
- `exclude_genres` (array, optional) — Genres to leave out (same values as `genres`).
- `subgenres` (array, optional) — JustWatch sub-genre short names (see `genres` → subgenres), e.g. 'superhero-movies'.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `age_certifications` (array, optional) — Age ratings as the market prints them (US: G, PG, PG-13, R, NC-17; GB: U, PG, 12, 15, 18 …) — see `age_ratings`.
- `production_countries` (array, optional) — Only titles produced in these countries (ISO-2).
- `exclude_production_countries` (array, optional) — Leave out titles produced in these countries (ISO-2).
- `year_min` (integer, optional) — Earliest release year.
- `year_max` (integer, optional) — Latest release year.
- `imdb_score_min` (number, optional) — Minimum IMDb score (0-10).
- `imdb_score_max` (number, optional) — Maximum IMDb score (0-10).
- `imdb_votes_min` (integer, optional) — Minimum number of IMDb votes.
- `tomato_meter_min` (integer, optional) — Minimum Rotten Tomatoes Tomatometer (0-100).
- `runtime_min` (integer, optional) — Minimum runtime in minutes.
- `runtime_max` (integer, optional) — Maximum runtime in minutes.
- `price_min` (number, optional) — Minimum offer price in the market's currency (rent/buy offers).
- `price_max` (number, optional) — Maximum offer price in the market's currency (rent/buy offers).
- `include_titles_without_page` (boolean, optional, default false) — Also list titles JustWatch has no page for (its full catalogue: 3.3 M US titles vs 206 k with pages).
- `sort_by` (enum, optional, default "trending") — Ranking: popular (30-day popularity, the site default), trending (7-day), popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year (newest first), alphabetical, runtime, random (search also: relevance). alphabetical follows JustWatch's own sort key (titles starting with punctuation come first). Lists sorted this way stop at row 1,999. [one of: popular, trending, popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year, alphabetical, runtime, random, relevance]
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `offers` (enum, optional, default "best") — Offers per row: best = one per provider and payment type, as justwatch.com lists them (default) · all = every quality and disc offer · none = no offers (smallest rows). [one of: best, all, none]
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{id, object_type, title, original_title, year, release_date, url, description, runtime_minutes, age_certification, production_countries, genres, genre_names, imdb_id, tmdb_id, scoring{imdb_score, imdb_votes, tmdb_score, tmdb_popularity, jw_rating, jw_rating_percent, tomato_meter, certified_fresh}, likes, dislikes, votes, poster_url, popularity_rank{rank, trend, trend_difference}, offer_count, offers[]{provider, provider_id, provider_short_name, type, quality, price (as printed), price_printed_value, price_value (JustWatch's numeric field, can be 0.01 under the printed price), currency, previous_price_value, url, available_to, element_count, …}}, total, has_more, next_cursor

**Example request body:**
```json
{
  "object_types": [
    "movie"
  ]
}
```

### POST https://api.reefapi.com/justwatch/v1/charts — 1 credit
JustWatch Streaming Charts: daily, weekly or monthly top list of a market (optionally of one or more providers) with rank, trend, days in top 3/10/100/1000 and best rank ever.

**Parameters:**
- `period` (enum, optional, default "daily") — daily (default), weekly or monthly chart. [one of: daily, weekly, monthly]
- `object_type` (enum, optional, default "movie") — movie (default), show or season. [one of: movie, show, season]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `offers` (enum, optional, default "best") — Offers per row: best = one per provider and payment type, as justwatch.com lists them (default) · all = every quality and disc offer · none = no offers (smallest rows). [one of: best, all, none]
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{chart{rank, trend, trend_difference, top_rank, days_in_top_3, days_in_top_10, days_in_top_100, days_in_top_1000, updated_at}, …title row}, total, next_cursor

**Example request body:**
```json
{
  "country": "US",
  "page_size": 10
}
```

### POST https://api.reefapi.com/justwatch/v1/title — 1 credit
Everything justwatch.com shows for one movie, show or season in a market: all offers (every provider, payment type, quality, price, link, leaving date), JustWatch rating, IMDb/TMDB/Rotten Tomatoes scores, popularity rank and streaming-chart position, genres, sub-genres, tags, age rating, runtime, synopsis, full cast and directors, seasons, trailers, backdrops, Wikidata/Wikipedia.

**Parameters:**
- `id` (string, optional) — JustWatch title id: tm… movie, ts… show, tss… season (from any result's `id`).
- `url` (string, optional) — A justwatch.com title URL or path, e.g. https://www.justwatch.com/us/movie/inception.
- `query` (string, optional) — Title name when you have no id or URL; the first search match is used.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.

**Returns:** one title{…title row, synopsis, cast[], directors[], credits_total, seasons[], offers[], leaving[], streaming_chart, upcoming_releases[], clips[], backdrops[], tags[], subgenres[], age_certification_details, wikidata_id, wikipedia_url}

**Example request body:**
```json
{
  "id": "tm92641",
  "country": "US"
}
```

### POST https://api.reefapi.com/justwatch/v1/titles — 1 credit
Up to 50 titles by id in ONE request (batch of `title` rows with offers).

**Parameters:**
- `ids` (array, required) — JustWatch title ids (tm…/ts…/tss…), up to 50.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `offers` (enum, optional, default "best") — Offers per row: best = one per provider and payment type, as justwatch.com lists them (default) · all = every quality and disc offer · none = no offers (smallest rows). [one of: best, all, none]

**Returns:** results[] (title rows, input order), not_found[]

**Example request body:**
```json
{
  "ids": [
    "tm92641",
    "ts4"
  ]
}
```

### POST https://api.reefapi.com/justwatch/v1/credits — 1 credit
Full cast and directors of a movie or show (every credit JustWatch lists, with character names and person ids).

**Parameters:**
- `id` (string, optional) — JustWatch title id: tm… movie, ts… show, tss… season (from any result's `id`).
- `url` (string, optional) — A justwatch.com title URL or path, e.g. https://www.justwatch.com/us/movie/inception.
- `query` (string, optional) — Title name when you have no id or URL; the first search match is used.
- `role` (array, optional) — actor, director or guest_actor (default: all). [one of: actor, director, guest_actor]
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.

**Returns:** id, title, credits[]{name, role, character, person_id}, total, by_role

**Example request body:**
```json
{
  "url": "https://www.justwatch.com/us/movie/inception"
}
```

### POST https://api.reefapi.com/justwatch/v1/availability — 2 credits
Where to watch one title in many markets at once — every offer per country (up to 60 countries in one request).

**Parameters:**
- `id` (string, optional) — JustWatch title id: tm… movie, ts… show, tss… season (from any result's `id`).
- `url` (string, optional) — A justwatch.com title URL or path, e.g. https://www.justwatch.com/us/movie/inception.
- `query` (string, optional) — Title name when you have no id or URL; the first search match is used.
- `countries` (array, optional) — ISO-2 markets (up to 60); 'all' = every JustWatch market (in batches of 60).
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.

**Returns:** id, title, countries{CC: offers[]}, summary{CC: {offers, providers, flatrate, rent, buy, free}}

**Example request body:**
```json
{
  "id": "tm92641",
  "countries": "US,GB,DE"
}
```

### POST https://api.reefapi.com/justwatch/v1/similar — 1 credit
Titles JustWatch recommends as similar to one title, with similarity score.

**Parameters:**
- `id` (string, optional) — JustWatch title id: tm… movie, ts… show, tss… season (from any result's `id`).
- `url` (string, optional) — A justwatch.com title URL or path, e.g. https://www.justwatch.com/us/movie/inception.
- `query` (string, optional) — Title name when you have no id or URL; the first search match is used.
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `genres` (array, optional) — Genres by short name (act, cmy, drm, hrr …) or name ('Action', 'Comedy') — see `genres`.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `page_size` (integer, optional, default 20) — How many (1-100).
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `offers` (enum, optional, default "best") — Offers per row: best = one per provider and payment type, as justwatch.com lists them (default) · all = every quality and disc offer · none = no offers (smallest rows). [one of: best, all, none]

**Returns:** results[]{similarity_score, …title row}

**Example request body:**
```json
{
  "url": "https://www.justwatch.com/us/movie/inception"
}
```

### POST https://api.reefapi.com/justwatch/v1/seasons — 1 credit
Seasons of a show with episode counts and the offers for each season.

**Parameters:**
- `id` (string, optional) — JustWatch title id: tm… movie, ts… show, tss… season (from any result's `id`).
- `url` (string, optional) — A justwatch.com title URL or path, e.g. https://www.justwatch.com/us/movie/inception.
- `query` (string, optional) — Title name when you have no id or URL; the first search match is used.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.

**Returns:** show{id, title}, seasons[]{id, season_number, title, year, episode_count, offers[]}

**Example request body:**
```json
{
  "url": "https://www.justwatch.com/us/movie/inception"
}
```

### POST https://api.reefapi.com/justwatch/v1/episodes — 1 credit
Episodes of a season (season id, or show id/url + season_number) with offers, paged by JustWatch itself.

**Parameters:**
- `season_id` (string, optional) — Season id (tss…).
- `id` (string, optional) — JustWatch title id: tm… movie, ts… show, tss… season (from any result's `id`).
- `url` (string, optional) — A justwatch.com title URL or path, e.g. https://www.justwatch.com/us/movie/inception.
- `query` (string, optional) — Title name when you have no id or URL; the first search match is used.
- `season_number` (integer, optional) — With a show id/url/query: which season.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** season{id, season_number, show}, results[]{id, season_number, episode_number, title, description, runtime_minutes, offers[]}, total, has_more, next_cursor

**Example request body:**
```json
{
  "url": "https://www.justwatch.com/us/movie/inception"
}
```

### POST https://api.reefapi.com/justwatch/v1/new — 1 credit
justwatch.com's New page: titles added to a market's providers on a day, coming soon, leaving soon, or with a price drop — with the offer that changed and its date. Each feed stops at 600 rows. leaving_soon is re-ordered by JustWatch on every request, so pages can repeat a few rows: filter by provider (Netflix US: 100 rows, one page) and de-duplicate on change.offer_id.

**Parameters:**
- `page_type` (enum, optional, default "new") — new (default), upcoming, leaving_soon, price_drop. [one of: new, upcoming, leaving_soon, price_drop]
- `date` (string, optional) — Day of the change, YYYY-MM-DD (default today, market time; new/price_drop).
- `bucket` (enum, optional) — upcoming / leaving_soon window: today, tomorrow, next_7_days, next_30_days. [one of: today, tomorrow, next_7_days, next_30_days]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `genres` (array, optional) — Genres by short name (act, cmy, drm, hrr …) or name ('Action', 'Comedy') — see `genres`.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `age_certifications` (array, optional) — Age ratings as the market prints them (US: G, PG, PG-13, R, NC-17; GB: U, PG, 12, 15, 18 …) — see `age_ratings`.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{change{provider, type, quality, price_value, previous_price_value, price_change_percent, date_created, available_to, new_element_count, url}, …title row}, total

**Example request body:**
```json
{
  "country": "US",
  "providers": "nfx",
  "page_type": "leaving_soon",
  "page_size": 5
}
```

### POST https://api.reefapi.com/justwatch/v1/new_counts — 1 credit
How many titles each provider added (or will add / remove) per day — the counts behind justwatch.com's New timeline.

**Parameters:**
- `page_type` (enum, optional, default "new") — new (default), upcoming, leaving_soon, price_drop. [one of: new, upcoming, leaving_soon, price_drop]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `page_size` (integer, optional, default 20) — Day×provider buckets per page (1-20, JustWatch's maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{date, provider, provider_id, provider_short_name, count}, has_more, next_cursor

**Example request body:**
```json
{
  "page_type": "new"
}
```

### POST https://api.reefapi.com/justwatch/v1/person — 1 credit
A person (actor/director): name, biography, date of birth, portrait, and their filmography in the market with offers — every title filter and sort applies.

**Parameters:**
- `id` (string, optional) — Person id (tp1725 or 1725) from credits / search_people.
- `name` (string, optional) — Person name when you have no id (first match is used).
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `genres` (array, optional) — Genres by short name (act, cmy, drm, hrr …) or name ('Action', 'Comedy') — see `genres`.
- `exclude_genres` (array, optional) — Genres to leave out (same values as `genres`).
- `subgenres` (array, optional) — JustWatch sub-genre short names (see `genres` → subgenres), e.g. 'superhero-movies'.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `presentation_types` (array, optional) — Video quality of the offers: sd, hd, 4k (also dvd, bluray, bluray_4k for discs). [one of: sd, hd, 4k, dvd, bluray, bluray_4k]
- `age_certifications` (array, optional) — Age ratings as the market prints them (US: G, PG, PG-13, R, NC-17; GB: U, PG, 12, 15, 18 …) — see `age_ratings`.
- `production_countries` (array, optional) — Only titles produced in these countries (ISO-2).
- `exclude_production_countries` (array, optional) — Leave out titles produced in these countries (ISO-2).
- `year_min` (integer, optional) — Earliest release year.
- `year_max` (integer, optional) — Latest release year.
- `imdb_score_min` (number, optional) — Minimum IMDb score (0-10).
- `imdb_score_max` (number, optional) — Maximum IMDb score (0-10).
- `imdb_votes_min` (integer, optional) — Minimum number of IMDb votes.
- `tomato_meter_min` (integer, optional) — Minimum Rotten Tomatoes Tomatometer (0-100).
- `runtime_min` (integer, optional) — Minimum runtime in minutes.
- `runtime_max` (integer, optional) — Maximum runtime in minutes.
- `price_min` (number, optional) — Minimum offer price in the market's currency (rent/buy offers).
- `price_max` (number, optional) — Maximum offer price in the market's currency (rent/buy offers).
- `include_titles_without_page` (boolean, optional, default false) — Also list titles JustWatch has no page for (its full catalogue: 3.3 M US titles vs 206 k with pages).
- `sort_by` (enum, optional, default "popular") — Ranking: popular (30-day popularity, the site default), trending (7-day), popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year (newest first), alphabetical, runtime, random (search also: relevance). alphabetical follows JustWatch's own sort key (titles starting with punctuation come first). Lists sorted this way stop at row 1,999. [one of: popular, trending, popular_7_days, popular_180_days, imdb_score, tmdb_popularity, release_year, alphabetical, runtime, random, relevance]
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `offers` (enum, optional, default "best") — Offers per row: best = one per provider and payment type, as justwatch.com lists them (default) · all = every quality and disc offer · none = no offers (smallest rows). [one of: best, all, none]
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** person{id, name, description, date_of_birth, portrait_url}, results[] (filmography title rows), total, next_cursor

**Example request body:**
```json
{
  "id": "tp1725"
}
```

### POST https://api.reefapi.com/justwatch/v1/search_people — 1 credit
Find actors and directors by name.

**Parameters:**
- `query` (string, required) — Name to search for.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{id, name, date_of_birth, portrait_url}, total, next_cursor

**Example request body:**
```json
{
  "query": "Inception"
}
```

### POST https://api.reefapi.com/justwatch/v1/suggest — 1 credit
Search-box suggestions: matching titles and people in one call.

**Parameters:**
- `query` (string, required) — What the user typed.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `page_size` (integer, optional, default 10) — Suggestions per kind (1-30).

**Returns:** titles[]{id, title, year, object_type, url, poster_url}, people[]{id, name}

**Example request body:**
```json
{
  "query": "Inception"
}
```

### POST https://api.reefapi.com/justwatch/v1/providers — 1 credit
Every streaming / rental service JustWatch tracks in a market, with subscription plan prices, payment types, add-on channels and bundles.

**Parameters:**
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.

**Returns:** providers[]{provider, provider_id, short_name, technical_name, monetization_types, plans[], addons[], bundles[], icon}

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/justwatch/v1/provider — 2 credits
One provider in a market: plans and prices, add-ons, bundles, and its catalogue size (all titles, movies, shows) as JustWatch counts it.

**Parameters:**
- `provider` (string, required) — Short name, name, technical name or id (nfx, Netflix, 8).
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.

**Returns:** provider{…, catalogue{titles, movies, shows}}

**Example request body:**
```json
{
  "provider": "nfx"
}
```

### POST https://api.reefapi.com/justwatch/v1/provider_compare — 2 credits
Compare providers' catalogues across markets: titles, movies and shows per provider per country (up to 60 country×provider pairs in one request).

**Parameters:**
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `countries` (array, optional) — ISO-2 markets to compare.
- `genres` (array, optional) — Genres by short name (act, cmy, drm, hrr …) or name ('Action', 'Comedy') — see `genres`.
- `monetization_types` (array, optional) — How you pay: flatrate (subscription), rent, buy, free, ads (free with ads), cinema, fast. Singular/plural and 'subscription' accepted. [one of: flatrate, rent, buy, free, ads, cinema, fast]
- `object_types` (array, optional) — movie and/or show (singular, plural and 'tv' accepted). [one of: movie, show]
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.

**Returns:** results[]{country, provider, provider_short_name, titles, movies, shows}, not_in_market[]

**Example request body:**
```json
{
  "providers": "nfx"
}
```

### POST https://api.reefapi.com/justwatch/v1/countries — 0 credits
Every market JustWatch serves: ISO code, name, currency, site language, URL part, timezone.

**Parameters:** none

**Returns:** countries[]{code, name, currency, currency_name, language, locale, url, timezone, names{…}}

### POST https://api.reefapi.com/justwatch/v1/country — 1 credit
One market: its locale details plus every provider available there.

**Parameters:**
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.

**Returns:** country{code, name, currency, language, …, providers[]}

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/justwatch/v1/genres — 1 credit
JustWatch genres (short names for filters) and the market's sub-genres.

**Parameters:**
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.

**Returns:** genres[]{short_name, technical_name, name, slug}, subgenres[]{short_name, name, url}

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/justwatch/v1/age_ratings — 1 credit
Age ratings a market uses for movies and shows (values for the age_certifications filter).

**Parameters:**
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).

**Returns:** movies[]{id, name, min_age, organization}, shows[]

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/justwatch/v1/sports_events — 1 credit
Upcoming live sports events in a market with where to watch them (JustWatch Sports): filter by sport, competition, provider and date range.

**Parameters:**
- `sports` (array, optional) — football (soccer), american_football, basketball, baseball, ice_hockey, tennis, cricket, rugby, formula_racing, nascar, esports_*.
- `competition_ids` (array, optional) — Competition ids from sports_competitions.
- `date_from` (string, optional) — Start of window (YYYY-MM-DD, default today).
- `days` (integer, optional, default 7) — Window length in days (1-30, default 7).
- `providers` (array, optional) — Streaming services: JustWatch short name (nfx, amp, dnp …), name ('Netflix'), technical name or provider id — see `providers`. Unknown names are refused with suggestions.
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{id, sport, name, status, start_at, competition, home, away, venue, offers[]{provider, type, quality, audio_language, url}}

**Example request body:**
```json
{
  "sports": [
    "football"
  ]
}
```

### POST https://api.reefapi.com/justwatch/v1/sports_competitions — 1 credit
Sports competitions/leagues JustWatch tracks in a market (each row names its sport; JustWatch offers no sport filter here).

**Parameters:**
- `active_on` (string, optional) — Only competitions with a season running on this day (YYYY-MM-DD).
- `country` (string, optional, default "US") — Market as ISO-2 code (US, GB, DE, TR, IN …) or country name. Offers, prices, providers and charts are per market; JustWatch serves 139 markets (see `countries`).
- `language` (string, optional) — ISO-639-1 language for titles, descriptions and genre names. Default: the market's own site language (de for DE, tr for TR, ja for JP, en for US). A language JustWatch has no text for falls back to English.
- `page_size` (integer, optional, default 20) — Rows per page, 1-100 (JustWatch's own maximum).
- `cursor` (string, optional) — `meta.next_cursor` / `data.next_cursor` of the previous page.

**Returns:** results[]{id, name, sport, url, icon}, total

**Example request body:**
```json
{
  "active_on": "2026-11-16"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=justwatch
- Human docs page: https://reefapi.com/docs/justwatch
- Overview page: https://reefapi.com/justwatch-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
