JustWatch API: List streaming chart titles
Lists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service.
Unofficial. Not affiliated with or endorsed by JustWatch.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Country optional
country Country name or two-letter code, for example Germany or DE.
United States
Default
United States.- Service optional
service One streaming service, for example Netflix. Leave blank for all services.
Netflix
Default
.- Max Results optional
max_results Most titles to return, for example 20.
20
Whole number from 1 to 100. Default
20.- Content Type optional
content_type Which chart to list, for example movies.
movies
One of
movies,shows. Defaultmovies.
Input as JSON
{ "country": "United States", "service": "Netflix", "max_results": 20, "content_type": "movies"}Output
{ "charts": [ { "rank": 14, "type": "movie", "year": 1980, "title": "Friday the 13th", "services": [ "Netflix", "Paramount Plus Premium", "Paramount Plus Essential" ], "rank_change": -3, "justwatch_link": "https://www.justwatch.com/us/movie/friday-the-13th-1980" , "justwatch_rating_percent": 87 }, { "rank": 15, "type": "movie", "year": 2016, "title": "Green Room", "services": [ "Netflix", "JustWatch TV Free", "JustWatch TV Plus" ], "rank_change": 0, "justwatch_link": "https://www.justwatch.com/us/movie/green-room" , "justwatch_rating_percent": 88 }, { "rank": 19, "type": "movie", "year": 2026, "title": "Sacrifice", "services": [ "Netflix", "Netflix Standard with Ads" ], "rank_change": 0, "justwatch_link": "https://www.justwatch.com/us/movie/sacrifice-2025-1" , "justwatch_rating_percent": 41 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"justwatch.com/list_streaming_charts","input":{"country":"United States","service":"Netflix","max_results":20,"content_type":"movies"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "justwatch.com/list_streaming_charts" , "input": { "country": "United States", "service": "Netflix", "max_results": 20, "content_type": "movies" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "justwatch.com/list_streaming_charts" , "input": { "country": "United States", "service": "Netflix", "max_results": 20, "content_type": "movies" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run justwatch.com/list_streaming_charts# with {"country":"United States","service":"Netflix","max_results":20,"content_type":"movies"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, for example Germany or DE." }, "service": { "type": "string", "default": "", "description": "One streaming service, for example Netflix. Leave blank for all services." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Most titles to return, for example 20." }, "content_type": { "enum": [ "movies", "shows" ], "type": "string", "default": "movies", "description": "Which chart to list, for example movies." } }}Output schema
{ "type": "object", "required": [ "charts" ], "properties": { "charts": { "type": "array", "items": { "type": "object", "required": [ "rank", "rank_change", "title", "year", "type", "justwatch_rating_percent", "services", "justwatch_link" ], "properties": { "rank": { "type": "integer", "description": "Position on the daily chart." }, "type": { "enum": [ "movie", "show" ], "type": "string" }, "year": { "type": [ "integer", "null" ] }, "title": { "type": "string" }, "services": { "type": "array", "items": { "type": "string" }, "description": "Services offering the title, including subscription, rental or purchase services." }, "rank_change": { "type": [ "integer", "null" ], "description": "Position change since yesterday; positive means moved up, null if new or unavailable." }, "justwatch_link": { "type": "string" }, "justwatch_rating_percent": { "type": [ "integer", "null" ], "description": "JustWatch rating as a percent, when available." } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
justwatch.com/list_streaming_charts- Returns
- rank, rank change, title, year, type, JustWatch rating, services, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method justwatch.com/list_streaming_charts with the inputs above.
Ask your agent
- What are the top 20 movies on the streaming chart in the United States today?
- Show me today's most popular TV shows streaming in Germany, limit 10.
- Which titles are climbing the daily chart on Netflix in Brazil right now?
- Give me the top 50 shows trending on Amazon Prime Video in Japan, with their ranks and rank changes.
- On justwatch.com, what movies are ranking highest for DE today on Disney Plus?
See more
All JustWatch methodsLists recently added movies and show seasons on streaming services in a country, newest first, from JustWatch listings.
justwatch.com/list_new_arrivalsFinds where a movie or show can be watched in a country on JustWatch. Returns streaming, rental and purchase offers with prices, plus ratings and whether it is in cinemas.
justwatch.com/get_where_to_watchLists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries.
open.spotify.com/list_top_podcastsLists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles.
imdb.com/list_top_chartsGets Kworb's latest YouTube music chart, worldwide or for one country, ordered by daily views. The worldwide chart covers the past 24 hours. Country charts report daily track streams.
kworb.net/get_youtube_music_chartLists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
play.google.com/list_top_chartsLists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
music.apple.com/list_top_chartsReturns the latest published Spotify daily Top 200 chart from Kworb for a country or worldwide, with rankings and stream counts.
kworb.net/get_spotify_daily_chart