# 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. - Page: https://fous.com/methods/netflix.com/list-top-10 - Method: `netflix.com/list_top_10`, version 1 - Website: netflix.com - Returns: week start and end, top 10 titles (rank, title, weeks in top 10, hours viewed, views, runtime, page link) - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `week` | string | no | | 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` | string | no | `"US"` | Global, a country name, or a two-letter country code. Example: United States. Default "global". | | `language` | string | no | | Language group for global lists only. Example: non_english. One of "english", "non_english". Default "english". | | `content_type` | string | no | | Movies or TV shows. Example: tv. One of "movies", "tv". Default "movies". | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "country": "US" } ``` Its output: ```json { "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" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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. ## Input schema ```json { "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 ```json { "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 } ``` ## See more - [Netflix API: List most popular titles](https://fous.com/methods/netflix.com/list-most-popular.md): Lists Netflix's all-time most popular movies or TV shows by views in their first 91 days, with views, hours viewed and runtime. - [Netflix API: Get movie or show](https://fous.com/methods/netflix.com/get-movie-or-show.md): Gets 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). - [JustWatch API: List streaming chart titles](https://fous.com/methods/justwatch.com/list-streaming-charts.md): Lists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service. - [Letterboxd API: List popular films](https://fous.com/methods/letterboxd.com/list-popular-films.md): Lists 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. - [themoviedb.org API: List trending movies and TV shows](https://fous.com/methods/themoviedb.org/list-trending.md): Lists 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. - [WEBTOON API: List rankings](https://fous.com/methods/webtoons.com/list-rankings.md): Lists 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. - [Box Office Mojo API: Get weekend box office chart](https://fous.com/methods/boxofficemojo.com/get-weekend-box-office.md): Returns 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. - [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists 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. - [All Netflix methods](https://fous.com/methods/netflix.com.md)