JustWatch API

Where every movie and show streams, with prices, in 139 countries

JustWatch (justwatch.com) tracks where movies and TV shows can be watched in 139 countries.

endpoints
25
credits per call
0–2

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

POST/justwatch/v1/search200
  1. Inception
    object_type
    MOVIE
    original_title
    Inception
    year
    2010
  2. Inception
    object_type
    MOVIE
    original_title
    Эхлэл
    year
    1980
  3. Drip Doge: The Movie
    object_type
    MOVIE
    original_title
    Drip Doge: The Movie
    year
    2022
Real result, captured Nov 16, 20263 of 5
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

JustWatch API

5 of 25 endpoints, ready to run

View docs ↗

Everything JustWatch knows about one title in a country

1 credit0 required · 2 optional
POST/justwatch/v1/title
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What JustWatch endpoints does ReefAPI ship?

25 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

25 endpoints

search

1 cr

Search movies and TV shows by name (JustWatch's own search), with every title filter, sort an…

required
query
optional
—

browse

1 cr

Browse a market's catalogue (justwatch.com's movies / TV shows pages) with every filter the s…

required
—
optional
—

trending

1 cr

What is trending on JustWatch right now (7-day popularity), with offers.

required
—
optional
—

charts

1 cr

JustWatch Streaming Charts.

required
—
optional
—

title

1 cr

Everything justwatch.com shows for one movie, show or season in a market.

required
—
optional
—

titles

1 cr

Up to 50 titles by id in ONE request (batch of title rows with offers).

required
ids
optional
—

credits

1 cr

Full cast and directors of a movie or show (every credit JustWatch lists, with character name…

required
—
optional
—

availability

2 cr

Where to watch one title in many markets at once.

required
—
optional
—

similar

1 cr

Titles JustWatch recommends as similar to one title, with similarity score.

required
—
optional
—

seasons

1 cr

Seasons of a show with episode counts and the offers for each season.

required
—
optional
—

episodes

1 cr

Episodes of a season (season id, or show id/url + season_number) with offers, paged by JustWa…

required
—
optional
—

new

1 cr

justwatch.com's New page.

required
—
optional
—

new_counts

1 cr

How many titles each provider added (or will add / remove) per day.

required
—
optional
—

person

1 cr

A person (actor/director).

required
—
optional
—

search_people

1 cr

Find actors and directors by name.

required
query
optional
—

suggest

1 cr

Search-box suggestions.

required
query
optional
—

providers

1 cr

Every streaming / rental service JustWatch tracks in a market, with subscription plan prices,…

required
—
optional
—

provider

2 cr

One provider in a market.

required
provider
optional
—

provider_compare

2 cr

Compare providers' catalogues across markets.

required
providers
optional
—

countries

0 cr

Every market JustWatch serves.

required
—
optional
—

country

1 cr

One market.

required
country
optional
—

genres

1 cr

JustWatch genres (short names for filters) and the market's sub-genres.

required
—
optional
—

age_ratings

1 cr

Age ratings a market uses for movies and shows (values for the age_certifications filter).

required
—
optional
—

sports_events

1 cr

Upcoming live sports events in a market with where to watch them (JustWatch Sports).

required
—
optional
—

sports_competitions

1 cr

Sports competitions/leagues JustWatch tracks in a market (each row names its sport.

required
—
optional
—

Every parameter, every allowed value →

Missing a JustWatch endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the JustWatch API works

JustWatch is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /justwatch/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
0 or 1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a title name to where it streams worldwide and what is like it

Resolve a title, read its offers in your market, compare countries, then find similar titles on the services you have.

01title?query=Dune&country=US
GET/justwatch/v1/title?query=Dune&country=US

Every US offer with price and quality, the JustWatch rating, cast and the JustWatch id.

02availability?id=<id>&countries=all
GET/justwatch/v1/availability?id=<id>&countries=all

The same title's offers in all 139 markets, with a per-country summary.

03similar?id=<id>&providers=nfx,amp
GET/justwatch/v1/similar?id=<id>&providers=nfx,amp

Similar titles that stream on the services you name.

04new?page_type=leaving_soon&providers=nfx
GET/justwatch/v1/new?page_type=leaving_soon&providers=nfx

What leaves Netflix soon, with the leaving date of each offer.

A dated where-to-watch map for one title across countries, plus related titles and upcoming changes.

request
curl -X POST https://api.reefapi.com/justwatch/v1/title \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"id":"tm92641","country":"US"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "justwatch",
    "endpoint": "title",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
offers[].price, price_printed_value, price_value, currencyprice 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[].typeJustWatch's payment type: FLATRATE (subscription), RENT, BUY, FREE, ADS (free with ads), CINEMA, FAST (free live channel).
offers[].qualitySD, 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_percentThe 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_toThe date the offer leaves the service, when JustWatch publishes one (10 % of sampled offers).
scoring.jw_rating_percentThe 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_rankJustWatch'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_certificationThe age rating the market prints on the title (TV-14, PG-13, 15, FSK 12 …). 9 of 9 pages that print it matched.
cast, directorsEveryone JustWatch credits, with character names and person ids; JustWatch lists actors, guest actors and directors, no other crew.
total on newJustWatch'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.

Coverage

JustWatch coverage, measured

Every number below was read from live justwatch.com data on 2026-11-16.

Markets

139 countries, each with its own offers, prices, currency and site language; 352 providers in the US, 161 in Germany.

Catalogue

206,119 US titles with a page (164,149 movies, 41,969 shows); 3,332,463 including titles JustWatch has no page for.

Values match the site

93 of 93 offers on 12 title pages in 8 countries matched the page the same minute (provider, payment type, quality, price to the cent); JustWatch rating, vote count and IMDb score 12 of 12; age rating 9 of 9.

Filters that bite

On 206,119 US titles: Netflix 8,294, horror 23,103, superhero 303, Korean productions 4,729, IMDb 8+ 11,555, Tomatometer 90+ 10,186, 4K 14,681, free with ads 84,992, released 2020-2021 17,725.

Round trip

88 of 88 ids from lists came back as the same title, year and type in title and in the 50-id batch.

Limits

100 rows per page; browse and trending stop at row 1,999 per filter set; change feeds at 600 rows; leaving-soon pages can repeat a few rows. No IMDb-id lookup, no offer history, no crew beyond directors upstream; logged-out data only.

Use cases

What people build with JustWatch

The jobs this data is most often used for.

25

endpoints

0/1/2

credits per call

01

Show users where a movie or series streams in their country, with rent and buy prices per quality.

02

Track what each streaming service added, is about to add or will remove this week.

03

Compare a service's catalogue size across countries, or one title's availability worldwide.

04

Build top-10 and trending widgets from JustWatch's daily, weekly and monthly charts.

Pricing

What JustWatch data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/justwatch/v1/title \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"id":"tm92641","country":"US"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/justwatch/v1/title",
    headers={"x-api-key": REEF_KEY},
    json={
        "id": "tm92641",
        "country": "US"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up JustWatch.

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.

Same key

43 Media, Film & Knowledge APIs on the same key

One key, one credit pool, one response envelope. If you are pulling JustWatch, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.