JustWatch API & Scraper
JustWatch (justwatch.com) tracks where movies and TV shows can be watched in 139 countries.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API reads it logged out and returns JSON. `title` gives everything a JustWatch title page shows for one market: every offer (provider, subscription / rent / buy / free / with ads, SD / HD / 4K, price and currency, link, leaving date), the JustWatch rating, IMDb, TMDB and Rotten Tomatoes scores, the JustWatch popularity rank and trend, genres, sub-genres, tags, age rating, runtime, synopsis, the full cast and directors, seasons and trailers. `availability` compares one title's offers across up to all 139 markets. `search` and `browse` cover the catalogue with every filter justwatch.com offers: provider, genre, sub-genre, type, payment type, quality, age rating, production country, release year, IMDb score and votes, Tomatometer, runtime and price. `charts` returns JustWatch's daily, weekly and monthly Streaming Charts, `new` the titles added, coming, leaving or dropping in price on each provider, `person` an actor's or director's filmography, and `providers` every service in a market with its subscription plans.
What a JustWatch field actually contains
Fields that read differently from how they look. Every row was measured against live justwatch.com data on 2026-11-16.
| Field | What it holds |
|---|---|
| offers[].price, price_printed_value, price_value, currency | price is the price exactly as the title page prints it ("19,90₺") and price_printed_value is that number (19.9). price_value is JustWatch's own numeric field, which sat 0.01 below the printed price on 305 of 5,223 priced offers in 73 countries (19.89 for "19,90₺"), 0.02 below on 12, and in zero-decimal markets is unrounded (3.5 for "IDR 4", 20 offers): 337 of 5,223 (6.5 %) differ, 10 of 162 in market-language titles. All three are returned. On 12 title pages in 8 countries, 93 of 93 offers matched the page's own offer data the same minute (provider, payment type, quality, price). |
| offers[].type | JustWatch's payment type: FLATRATE (subscription), RENT, BUY, FREE, ADS (free with ads), CINEMA, FAST (free live channel). |
| offers[].quality | SD, HD, 4K, or DVD / BLURAY / BLURAY_4K for disc offers. title returns every quality of every offer; list actions return one offer per provider and payment type, as the site lists them (offers=all gives every quality). |
| offers[].previous_price_value, price_change_percent | The price before JustWatch's last recorded change and the change in percent — the struck-through price on price drops. Set on 33 % of 3,842 sampled offers. |
| offers[].available_to | The date the offer leaves the service, when JustWatch publishes one (10 % of sampled offers). |
| scoring.jw_rating_percent | The JustWatch Rating the page prints next to the JustWatch icon (97 % for Inception). votes is the vote count beside it (34k). 12 of 12 pages matched. |
| popularity_rank | JustWatch's popularity rank in that country with trend and change. charts adds the Streaming Charts rank, best rank and days in the top 3 / 10 / 100 / 1000. |
| age_certification | The age rating the market prints on the title (TV-14, PG-13, 15, FSK 12 …). 9 of 9 pages that print it matched. |
| cast, directors | Everyone JustWatch credits, with character names and person ids; JustWatch lists actors, guest actors and directors, no other crew. |
| total on new | JustWatch's change feeds stop at 600 rows; a total of 600 means 600 or more (total_capped). |
Prices and offers are read live. The title page itself is served from a cache up to an hour old, so its popularity rank can lag the API: 5 of 9 pages showed the same rank.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/justwatch/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "Inception",
"country": "US",
"page_size": 5
}
}{
"ok": true,
"meta": {
"api": "justwatch",
"endpoint": "search",
"mode": "live",
"latency_ms": 305.4,
"record_count": 5,
"bytes": 15996,
"cache_hit": false,
"upstream_requests": 1,
"total": 49,
"has_more": true,
"next_cursor": "NQ==",
"charged_credits": 1,
"version": "1.0.0",
"request_id": "fb088673add34342",
"queue_ms": 1.1,
"fetched_at": "2026-11-16T21:05:24.231Z"
},
"data": {
"query": "Inception",
"country": "US",
"language": "en",
"sort_by": "popular",
"results": [
{
"id": "tm92641",
"object_id": 92641,
"object_type": "MOVIE",
"title": "Inception",
"original_title": "Inception",
"year": 2010,
"release_date": "2010-07-14",
"url": "https://www.justwatch.com/us/movie/inception",
"path": "/us/movie/inception",
"description": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
"runtime_minutes": 148,
"age_certification": "TV-14",
"production_countries": [
"GB",
"US"
],
"is_released": true,
"season_number": null,
"genres": [
"act",
"crm",
"trl"
],
"genre_names": [
"Action & Adventure",
"Crime",
"Mystery & Thriller"
],
"imdb_id": "tt1375666",
"tmdb_id": "27205",
"scoring": {
"imdb_score": 8.8,
"imdb_votes": 2889841,
"tmdb_score": 8.373,
"tmdb_popularity": 47.2662,
"jw_rating": 0.970439972184,
"jw_rating_percent": 97,
"tomato_meter": 86,
"certified_fresh": true
},
"likes": 32723,
"dislikes": 934,
"votes": 33657,
"poster_url": "https://images.justwatch.com/poster/302449148/s718/inception.jpg",
"popularity_rank": {
"rank": 197,
"trend": "UP",
"trend_difference": 34
},
"offer_count": 27,
"offers": [
{
"provider": "[trimmed-depth]",
"provider_id": "[trimmed-depth]",
"provider_short_name": "[trimmed-depth]",
"provider_technical_name": "[trimmed-depth]",
"provider_icon": "[trimmed-depth]",
"type": "[trimmed-depth]",
"quality": "[trimmed-depth]",
"price": "[trimmed-depth]",
"price_printed_value": "[trimmed-depth]",
"price_value": "[trimmed-depth]",
"currency": "[trimmed-depth]",
"previous_price": "[trimmed-depth]",
"previous_price_printed_value": "[trimmed-depth]",
"previous_price_value": "[trimmed-depth]",
"price_change_percent": "[trimmed-depth]",
"discounted_price": "[trimmed-depth]",
"discounted_price_value": "[trimmed-depth]",
"url": "[trimmed-depth]",
"element_count": "[trimmed-depth]",
"new_element_count": "[trimmed-depth]",
"seasons": "[trimmed-depth]",
"available_from": "[trimmed-depth]",
"available_to": "[trimmed-depth]",
"date_created": "[trimmed-depth]",
"updated_at": "[trimmed-depth]",
"audio_languages": "[trimmed-depth]",
"subtitle_languages": "[trimmed-depth]",
"video_technology": "[trimmed-depth]",
"audio_technology": "[trimmed-depth]",
"offer_type": "[trimmed-depth]",
"country": "[trimmed-depth]",
"offer_id": "[trimmed-depth]"
},
{
"provider": "[trimmed-depth]",
"provider_id": "[trimmed-depth]",
"provider_short_name": "[trimmed-depth]",
"provider_technical_name": "[trimmed-depth]",
"provider_icon": "[trimmed-depth]",
"type": "[trimmed-depth]",
"quality": "[trimmed-depth]",
"price": "[trimmed-depth]",
"price_printed_value": "[trimmed-depth]",
"price_value": "[trimmed-depth]",
"currency": "[trimmed-depth]",
"previous_price": "[trimmed-depth]",
"previous_price_printed_value": "[trimmed-depth]",
"previous_price_value": "[trimmed-depth]",
"price_change_percent": "[trimmed-depth]",
"discounted_price": "[trimmed-depth]",
"discounted_price_value": "[trimmed-depth]",
"url": "[trimmed-depth]",
"element_count": "[trimmed-depth]",
"new_element_count": "[trimmed-depth]",
"seasons": "[trimmed-depth]",
"available_from": "[trimmed-depth]",
"available_to": "[trimmed-depth]",
"date_created": "[trimmed-depth]",
"updated_at": "[trimmed-depth]",
"audio_languages": "[trimmed-depth]",
"subtitle_languages": "[trimmed-depth]",
"video_technology": "[trimmed-depth]",
"audio_technology": "[trimmed-depth]",
"offer_type": "[trimmed-depth]",
"country": "[trimmed-depth]",
"offer_id": "[trimmed-depth]"
},
{
"provider": "[trimmed-depth]",
"provider_id": "[trimmed-depth]",
"provider_short_name": "[trimmed-depth]",
"provider_technical_name": "[trimmed-depth]",
"provider_icon": "[trimmed-depth]",
"type": "[trimmed-depth]",
"quality": "[trimmed-depth]",
"price": "[trimmed-depth]",
"price_printed_value": "[trimmed-depth]",
"price_value": "[trimmed-depth]",
"currency": "[trimmed-depth]",
"previous_price": "[trimmed-depth]",
"previous_price_printed_value": "[trimmed-depth]",
"previous_price_value": "[trimmed-depth]",
"price_change_percent": "[trimmed-depth]",
"discounted_price": "[trimmed-depth]",
"discounted_price_value": "[trimmed-depth]",
"url": "[trimmed-depth]",
"element_count": "[trimmed-depth]",
"new_element_count": "[trimmed-depth]",
"seasons": "[trimmed-depth]",
"available_from": "[trimmed-depth]",
"available_to": "[trimmed-depth]",
"date_created": "[trimmed-depth]",
"updated_at": "[trimmed-depth]",
"audio_languages": "[trimmed-depth]",
"subtitle_languages": "[trimmed-depth]",
"video_technology": "[trimmed-depth]",
"audio_technology": "[trimmed-depth]",
"offer_type": "[trimmed-depth]",
"country": "[trimmed-depth]",
"offer_id": "[trimmed-depth]"
}
]
},
{
"id": "tm1537367",
"object_id": 1537367,
"object_type": "MOVIE",
"title": "Inception",
"original_title": "Эхлэл",
"year": 1980,
"release_date": "1980-01-23",
"url": null,
"path": "",
"description": "This film shows how ordinary people work to build the Erdenet factory, and how the finished product becomes the result of collective labor, and tells about the friendship of workers from Mongolia.",
"runtime_minutes": 77,
"age_certification": null,
"production_countries": [
"MN"
],
"is_released": true,
"season_number": null,
"genres": [
"drm"
],
"genre_names": [
"Drama"
],
"imdb_id": null,
"tmdb_id": "1359046",
"scoring": {
"imdb_score": null,
"imdb_votes": null,
"tmdb_score": null,
"tmdb_popularity": 1.2224,
"jw_rating": null,
"jw_rating_percent": null,
"tomato_meter": null,
"certified_fresh": null
},
"likes": 0,
"dislikes": 0,
"votes": 0,
"poster_url": null,
"popularity_rank": {
"rank": 0,
"trend": "",
"trend_difference": 0
},
"offer_count": 0,
"offers": []
},
{
"id": "tm1243481",
"object_id": 1243481,
"object_type": "MOVIE",
"title": "Drip Doge: The Movie",
"original_title": "Drip Doge: The Movie",
"year": 2022,
"release_date": null,
"url": null,
"path": "",
"description": null,
"runtime_minutes": null,
"age_certification": null,
"production_countries": [
"AF"
],
"is_released": true,
"season_number": null,
"genres": [
"act",
"trl"
],
"genre_names": [
"Action & Adventure",
"Mystery & Thriller"
],
"imdb_id": null,
"tmdb_id": "1011150",
"scoring": {
"imdb_score": null,
"imdb_votes": null,
"tmdb_score": null,
"tmdb_popularity": 1.4,
"jw_rating": null,
"jw_rating_percent": null,
"tomato_meter": null,
"certified_fresh": null
},
"likes": 0,
"dislikes": 0,
"votes": 0,
"poster_url": "https://images.justwatch.com/poster/297600954/s718/.jpg",
"popularity_rank": {
"rank": 0,
"trend": "",
"trend_difference": 0
},
"offer_count": 0,
"offers": []
}
],
"total": 49,
"offset": 0,
"has_more": true,
"next_cursor": "NQ=="
}
}What the JustWatch API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search movies and TV shows by name (JustWatch's own search), with every title filter, sort and where-to-watch offers per row. | Content platforms call search to search movies and TV shows by name (JustWatch's own search), with every title filter, sort an…. | query |
| browse | 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. | Research tools call browse to get browse a market's catalogue (justwatch.com's movies / TV shows pages) with every filter the s…. | none |
| trending | What is trending on JustWatch right now (7-day popularity), with offers; same filters as browse. | Community analysts call trending to get what is trending on JustWatch right now (7-day popularity), with offers; same filters as browse.. | none |
| charts | 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. | Media monitors call charts to get justWatch Streaming Charts. | none |
| title | 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. | Content platforms call title to get everything justwatch.com shows for one movie, show or season in a market. | none |
| titles | Up to 50 titles by id in ONE request (batch of `title` rows with offers). | Research tools call titles to get up to 50 titles by id in ONE request (batch of `title` rows with offers).. | ids |
| credits | Full cast and directors of a movie or show (every credit JustWatch lists, with character names and person ids). | Community analysts call credits to get full cast and directors of a movie or show (every credit JustWatch lists, with character name…. | none |
| availability | Where to watch one title in many markets at once — every offer per country (up to 60 countries in one request). | Media monitors call availability to get where to watch one title in many markets at once. | none |
| similar | Titles JustWatch recommends as similar to one title, with similarity score. | Content platforms call similar to get titles JustWatch recommends as similar to one title, with similarity score.. | none |
| seasons | Seasons of a show with episode counts and the offers for each season. | Research tools call seasons to get seasons of a show with episode counts and the offers for each season.. | none |
| episodes | Episodes of a season (season id, or show id/url + season_number) with offers, paged by JustWatch itself. | Community analysts call episodes to get episodes of a season (season id, or show id/url + season_number) with offers, paged by JustWa…. | none |
| new | 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. | Media monitors call new to get justwatch.com's New page. | none |
| new_counts | How many titles each provider added (or will add / remove) per day — the counts behind justwatch.com's New timeline. | Content platforms call new_counts to get how many titles each provider added (or will add / remove) per day. | none |
| person | A person (actor/director): name, biography, date of birth, portrait, and their filmography in the market with offers — every title filter and sort applies. | Research tools call person to get a person (actor/director). | none |
| search_people | Find actors and directors by name. | Community analysts call search_people to find actors and directors by name.. | query |
| suggest | Search-box suggestions: matching titles and people in one call. | Media monitors call suggest to get search-box suggestions. | query |
| providers | Every streaming / rental service JustWatch tracks in a market, with subscription plan prices, payment types, add-on channels and bundles. | Content platforms call providers to get every streaming / rental service JustWatch tracks in a market, with subscription plan prices,…. | none |
| provider | One provider in a market: plans and prices, add-ons, bundles, and its catalogue size (all titles, movies, shows) as JustWatch counts it. | Research tools call provider to get one provider in a market. | provider |
| provider_compare | Compare providers' catalogues across markets: titles, movies and shows per provider per country (up to 60 country×provider pairs in one request). | Community analysts call provider_compare to compare providers' catalogues across markets. | providers |
| countries | Every market JustWatch serves: ISO code, name, currency, site language, URL part, timezone. | Media monitors call countries to get every market JustWatch serves. | none |
| country | One market: its locale details plus every provider available there. | Content platforms call country to get one market. | country |
| genres | JustWatch genres (short names for filters) and the market's sub-genres. | Research tools call genres to get justWatch genres (short names for filters) and the market's sub-genres.. | none |
| age_ratings | Age ratings a market uses for movies and shows (values for the age_certifications filter). | Community analysts call age_ratings to get age ratings a market uses for movies and shows (values for the age_certifications filter).. | none |
| sports_events | Upcoming live sports events in a market with where to watch them (JustWatch Sports): filter by sport, competition, provider and date range. | Media monitors call sports_events to get upcoming live sports events in a market with where to watch them (JustWatch Sports). | none |
| sports_competitions | Sports competitions/leagues JustWatch tracks in a market (each row names its sport; JustWatch offers no sport filter here). | Content platforms call sports_competitions to get sports competitions/leagues JustWatch tracks in a market (each row names its sport; JustWatch…. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/justwatch/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"Inception","country":"US","page_size":5}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/justwatch/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "Inception",
"country": "US",
"page_size": 5
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/justwatch/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "Inception",
"country": "US",
"page_size": 5
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.justwatch.search with {"query":"Inception","country":"US","page_size":5}.Who uses this API and why
- Show users where a movie or series streams in their country, with rent and buy prices per quality.
- Track what each streaming service added, is about to add or will remove this week.
- Compare a service's catalogue size across countries, or one title's availability worldwide.
- Build top-10 and trending widgets from JustWatch's daily, weekly and monthly charts.
- Watch price drops on digital rentals and purchases with the previous price.
Questions developers ask before integrating
Do I need a JustWatch account?
No. Everything is read logged out, so watchlists, seen lists and personal recommendations are not available.
Which countries are covered?
The 139 markets justwatch.com serves; `countries` lists them with currency, site language and URL. Results depend only on the country you ask for.
Can I see where a title streams in every country at once?
Yes. availability with countries=all returns every offer in all 139 markets for one title; The Dark Knight had 1,334 offers across all markets on 2026-11-16.
Which filters can I use?
Provider, genre, excluded genre, sub-genre, movie or show, payment type, quality, age rating, production country (or excluded country), release year range, IMDb score and votes, Tomatometer, runtime and price. On 206,119 US titles: Netflix 8,294, horror 23,103, Korean productions 4,729, IMDb 8 or more 11,555, 4K offers 14,681, free 68,471.
How deep can I page?
100 rows per page. Browse and trending lists stop at row 1,999 for each filter combination, so narrow the filters to reach the rest; search, charts and filmographies page further. The new, upcoming, leaving and price-drop feeds stop at 600 rows.
Are the leaving-soon lists stable between pages?
Not fully: JustWatch re-orders titles leaving at the same time on every request, so a few rows can repeat between pages (14 of 60 in one test). Filter by provider to get the whole list in one page (Netflix US: 100 rows) and de-duplicate on change.offer_id.
Can I look a title up by IMDb id?
JustWatch offers no IMDb-id lookup. Every title carries its imdb_id and tmdb_id, and title also accepts a justwatch.com URL or a name.
Does it cover live sports?
Yes. sports_events returns upcoming games with the services that show them, filterable by sport, competition, provider and date; sports_competitions lists the 280 US competitions JustWatch tracks.
What is the JustWatch API?
JustWatch API is a ReefAPI endpoint group for where to watch any movie or tv show in 139 countries: every streaming, rent and buy offer with price and quality, charts, new and leaving titles, cast and people as json. It returns live JSON through POST requests under /justwatch/v1.
Is the JustWatch API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. JustWatch calls use the same shared credit balance as every other ReefAPI engine.
Do I need a JustWatch login or account?
No login to JustWatch is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the JustWatch data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the JustWatch API use?
JustWatch actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call JustWatch from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call justwatch actions with the same key, credit pool and JSON envelope used by normal REST requests.