Netflix API: List weekly Top 10
Gets Netflix's weekly Top 10 movies or TV shows worldwide (English or non-English lists, with views, hours viewed and runtime) or in one country (ranks and weeks in the Top 10 only) for the latest published week or the Monday-to-Sunday week containing a given date.
Unofficial. Not affiliated with or endorsed by Netflix.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Week optional
week Any date (YYYY-MM-DD) in the Monday-to-Sunday week to look up. Omit for the latest published week. Example: 2026-09-16.
Not set
- Country optional
country Global, a country name, or a two-letter country code. Example: United States.
US
Default
global.- Language optional
language Language group for global lists only. Example: non_english.
english (default)
One of
english,non_english.- Content Type optional
content_type Movies or TV shows. Example: tv.
movies (default)
One of
movies,tv.
Input as JSON
{ "country": "US"}Output
{ "top_10": [ { "rank": 1, "title": "Why Did I Get Married Again?", "views": null, "runtime": null, "page_link": "https://www.netflix.com/tudum/top10/united-states?week=2026-09-20" , "hours_viewed": null, "weeks_in_top_10": 2 }, { "rank": 2, "title": "The Seemingly Perfect Family", "views": null, "runtime": null, "page_link": "https://www.netflix.com/tudum/top10/united-states?week=2026-09-20" , "hours_viewed": null, "weeks_in_top_10": 1 }, { "rank": 3, "title": "The Ministry of Ungentlemanly Warfare", "views": null, "runtime": null, "page_link": "https://www.netflix.com/tudum/top10/united-states?week=2026-09-20" , "hours_viewed": null, "weeks_in_top_10": 1 } ], "week_end": "2026-09-20", "week_start": "2026-09-14"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"netflix.com/list_top_10","input":{"country":"US"}}' # 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": "netflix.com/list_top_10" , "input": { "country": "US" }})# 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": "netflix.com/list_top_10" , "input": { "country": "US" } }), 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 netflix.com/list_top_10# with {"country":"US"}"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": { "week": { "type": "string", "description": "Any date (YYYY-MM-DD) in the Monday-to-Sunday week to look up. Omit for the latest published week. Example: 2026-09-16." }, "country": { "type": "string", "default": "global", "description": "Global, a country name, or a two-letter country code. Example: United States." }, "language": { "enum": [ "english", "non_english" ], "type": "string", "default": "english", "description": "Language group for global lists only. Example: non_english." }, "content_type": { "enum": [ "movies", "tv" ], "type": "string", "default": "movies", "description": "Movies or TV shows. Example: tv." } }}Output schema
{ "type": "object", "required": [ "week_start", "week_end", "top_10" ], "properties": { "top_10": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "weeks_in_top_10", "hours_viewed", "views", "runtime", "page_link" ], "properties": { "rank": { "type": "integer" }, "title": { "type": "string" }, "views": { "type": [ "integer", "null" ] }, "runtime": { "type": [ "string", "null" ], "description": "Hours and minutes, such as 1:51." }, "page_link": { "type": "string", "description": "Official page showing this weekly ranking." }, "hours_viewed": { "type": [ "integer", "null" ] }, "weeks_in_top_10": { "type": "integer" } }, "additionalProperties": false }, "description": "Titles in rank order. Viewing figures are unavailable for countries and for some older global weeks." }, "week_end": { "type": "string", "format": "date", "description": "Last day of the ranking week." }, "week_start": { "type": "string", "format": "date", "description": "First day of the ranking week." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
netflix.com/list_top_10- Returns
- week start and end, top 10 titles (rank, title, weeks in top 10, hours viewed, views, runtime, page 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 netflix.com/list_top_10 with the inputs above.
Ask your agent
- What are the top 10 non-English TV shows on Netflix globally this week, with hours viewed?
- Show me the most-watched TV series in Brazil for the week of March 12, 2025.
- Which English-language movies ranked in the global top 10 during the week that included 2024-11-28? Include views and runtime.
- I need Japan's Netflix top 10 movies for the latest published week, with how many weeks each has been on the chart.
- List the 10 most popular foreign-language films worldwide for the week containing July 4, 2025, along with view counts.
See more
All Netflix methodsLists Netflix's all-time most popular movies or TV shows by views in their first 91 days, with views, hours viewed and runtime.
netflix.com/list_most_popularGets one Netflix movie or series by its exact name or Netflix title URL: title details, publicly shown seasons and episodes, and whether it is available in a given country's catalogue (checked against public JustWatch listings).
netflix.com/get_movie_or_showLists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service.
justwatch.com/list_streaming_chartsLists Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films.
letterboxd.com/list_popular_filmsLists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those.
themoviedb.org/list_trendingLists popular or trending WEBTOON series in ranking order, with authors and displayed subscriber and view counts. Genre filtering keeps matching series from the public top 30.
webtoons.com/list_rankingsReturns ranked box office grosses for a weekend in a market. Defaults to the latest reported US and Canada weekend; international markets use their own weekend calendar.
boxofficemojo.com/get_weekend_box_officeLists 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_charts