Netflix API: Get movie or show
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).
Unofficial. Not affiliated with or endorsed by Netflix.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Title, required
title The exact name identifying one Netflix movie or series, or its Netflix title URL. This is a single-item lookup, not a keyword search. Example: Stranger Things; https://www.netflix.com/title/80057281. A nonexistent title or title URL is a not-found input outcome.
Stranger Things
- Country optional
country Country to check by name or two-letter code. Example: United Kingdom
United States (default)
Input as JSON
{ "title": "Stranger Things"}Output
{ "cast": [ "Winona Ryder", "David Harbour", "Millie Bobby Brown" ], "type": "series", "year": 2025, "title": "Stranger Things", "genres": [ "TV Dramas", "Sci-Fi Shows", "Teen TV Shows" ], "seasons": [ { "season": "Season 1", "episodes": [ { "title": "Chapter One: The Vanishing of Will Byers", "runtime": "49m", "synopsis": "On his way home from a friend's house, young Will sees something terrifying. Nearby, a sinister secret lurks in the depths of a government lab.", "episode_number": 1 }, { "title": "Chapter Two: The Weirdo on Maple Street", "runtime": "56m", "synopsis": "Lucas, Mike and Dustin try to talk to the girl they found in the woods. Hopper questions an anxious Joyce about an unsettling phone call.", "episode_number": 2 }, { "title": "Chapter Three: Holly, Jolly", "runtime": "52m", "synopsis": "An increasingly concerned Nancy looks for Barb and finds out what Jonathan's been up to. Joyce is convinced Will is trying to talk to her.", "episode_number": 3 } ] }, { "season": "Season 2", "episodes": [ { "title": "Chapter One: MADMAX", "runtime": "49m", "synopsis": "As the town preps for Halloween, a high-scoring rival shakes things up at the arcade, and a skeptical Hopper inspects a field of rotting pumpkins.", "episode_number": 1 }, { "title": "Chapter Two: Trick or Treat, Freak", "runtime": "56m", "synopsis": "After Will sees something terrible on trick-or-treat night, Mike wonders whether Eleven's still out there. Nancy wrestles with the truth about Barb.", "episode_number": 2 }, { "title": "Chapter Three: The Pollywog", "runtime": "51m", "synopsis": "Dustin adopts a strange new pet, and Eleven grows increasingly impatient. A well-meaning Bob urges Will to stand up to his fears.", "episode_number": 3 } ] }, { "season": "Season 3", "episodes": [ { "title": "Chapter One: Suzie, Do You Copy?", "runtime": "51m", "synopsis": "Summer brings new jobs and budding romance. But the mood shifts when Dustin's radio picks up a Russian broadcast, and Will senses something is wrong.", "episode_number": 1 }, { "title": "Chapter Two: The Mall Rats", "runtime": "51m", "synopsis": "Nancy and Jonathan follow a lead, Steve and Robin sign on to a secret mission, and Max and Eleven go shopping. A rattled Billy has troubling visions.", "episode_number": 2 }, { "title": "Chapter Three: The Case of the Missing Lifeguard", "runtime": "50m", "synopsis": "With El and Max looking for Billy, Will declares a day without girls. Steve and Dustin go on a stakeout, and Joyce and Hopper return to Hawkins Lab.", "episode_number": 3 } ] } ], "creators": [ "The Duffer Brothers" ], "description": "When a young boy vanishes, a small town uncovers a mystery involving secret experiments, terrifying supernatural forces and one strange little girl.", "netflix_link": "https://www.netflix.com/title/80057281" , "maturity_rating": "TV-14", "netflix_title_id": "80057281", "available_in_country": true}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"netflix.com/get_movie_or_show","input":{"title":"Stranger Things"}}' # 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/get_movie_or_show" , "input": { "title": "Stranger Things" }})# 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/get_movie_or_show" , "input": { "title": "Stranger Things" } }), 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/get_movie_or_show# with {"title":"Stranger Things"}"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", "required": [ "title" ], "properties": { "title": { "type": "string", "description": "The exact name identifying one Netflix movie or series, or its Netflix title URL. This is a single-item lookup, not a keyword search. Example: Stranger Things; https://www.netflix.com/title/80057281. A nonexistent title or title URL is a not-found input outcome." }, "country": { "type": "string", "default": "United States", "description": "Country to check by name or two-letter code. Example: United Kingdom" } }}Output schema
{ "type": "object", "required": [ "title", "year", "type", "maturity_rating", "genres", "description", "cast", "creators", "available_in_country", "netflix_link", "seasons", "netflix_title_id" ], "properties": { "cast": { "type": "array", "items": { "type": "string" } }, "type": { "enum": [ "movie", "series" ], "type": "string" }, "year": { "type": [ "integer", "null" ] }, "title": { "type": "string" }, "genres": { "type": "array", "items": { "type": "string" } }, "seasons": { "type": "array", "items": { "type": "object", "required": [ "season", "episodes" ], "properties": { "season": { "type": "string" }, "episodes": { "type": "array", "items": { "type": "object", "required": [ "episode_number", "title", "runtime", "synopsis" ], "properties": { "title": { "type": "string" }, "runtime": { "type": [ "string", "null" ] }, "synopsis": { "type": [ "string", "null" ] }, "episode_number": { "type": [ "integer", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } }, "creators": { "type": "array", "items": { "type": "string" } }, "description": { "type": [ "string", "null" ] }, "netflix_link": { "type": "string" }, "maturity_rating": { "type": [ "string", "null" ] }, "netflix_title_id": { "type": "string", "x-fous-developer": true }, "available_in_country": { "type": "boolean" } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
netflix.com/get_movie_or_show- Returns
- title, year, type, maturity rating, genres, description, cast, creators, country availability, Netflix link, seasons with episodes
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/get_movie_or_show with the inputs above.
Ask your agent
- Is Wednesday available to stream in Canada? I'd also like the cast and how many seasons there are.
- Pull up the details for https://www.netflix.com/title/81040344 — maturity rating, genres, and the full episode list.
- Can I watch The Crown on Netflix in Germany? Give me the creators and a short description too.
- What's the release year and plot summary of Glass Onion, and is it in the UK catalogue?
- List every season and episode of Money Heist on Netflix, and tell me if it's offered in Japan.
See more
All Netflix methodsGets 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.
netflix.com/list_top_10Lists 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 a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null.
imdb.com/get_movie_or_showFinds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country.
themoviedb.org/get_movieFinds 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_watchGets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series.
rottentomatoes.com/get_scoresFinds a TV show on TMDB by exact name or TMDB show link and returns its details, cast, seasons, the last aired and next scheduled episodes, and the streaming services listed for a chosen country.
themoviedb.org/get_tv_showGets age certifications and non-spoiler Parents Guide summaries (severity votes and example descriptions for five categories) for a movie or show by title, IMDb link or title ID. A year selects a specific release.
imdb.com/get_parents_guide