Fandango API: List movies now playing or coming soon
Lists Fandango movies now playing or coming soon in U.S. theaters, in Fandango's order, with release dates, age ratings, runtimes and Rotten Tomatoes scores when shown.
Unofficial. Not affiliated with or endorsed by Fandango.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- List optional
list Which movie list to show, for example now_playing.
now_playing (default)
One of
now_playing,coming_soon.- Max Results optional
max_results Maximum movies to return, for example 50.
50
Whole number from 1 to 100. Default
50.
Input as JSON
{ "max_results": 50}Output
{ "movies": [ { "title": "Resident Evil (2026)", "runtime": null, "age_rating": "NR", "poster_link": "https://images.fandango.com/ImageRenderer/300/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterRepository/fandango/245893/RES_Online_1400x2100_TSR_Shadow_IPF-IMAX_01.jpg" , "tomatometer": 96, "release_date": "2026-09-18", "fandango_link": "https://www.fandango.com/resident-evil-2026-245893/movie-overview" , "audience_score": 91 }, { "title": "Heart of the Beast (2026)", "runtime": "1 hr 41 min", "age_rating": "PG-13", "poster_link": "https://images.fandango.com/ImageRenderer/300/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterRepository/fandango/246224/heartofthebeast.jpg" , "tomatometer": 86, "release_date": "2026-09-25", "fandango_link": "https://www.fandango.com/heart-of-the-beast-2026-246224/movie-overview" , "audience_score": 94 }, { "title": "Forgotten Island (2026)", "runtime": "1 hr 49 min", "age_rating": "PG", "poster_link": "https://images.fandango.com/ImageRenderer/300/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterRepository/fandango/246370/forgottenisland-posterart.jpg" , "tomatometer": 95, "release_date": "2026-09-25", "fandango_link": "https://www.fandango.com/forgotten-island-2026-246370/movie-overview" , "audience_score": 97 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"fandango.com/list_now_playing","input":{"max_results":50}}' # 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": "fandango.com/list_now_playing" , "input": { "max_results": 50 }})# 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": "fandango.com/list_now_playing" , "input": { "max_results": 50 } }), 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 fandango.com/list_now_playing# with {"max_results":50}"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": [], "properties": { "list": { "enum": [ "now_playing", "coming_soon" ], "type": "string", "default": "now_playing", "description": "Which movie list to show, for example now_playing." }, "max_results": { "type": "integer", "default": 50, "maximum": 100, "minimum": 1, "description": "Maximum movies to return, for example 50." } }}Output schema
{ "type": "object", "required": [ "movies" ], "properties": { "movies": { "type": "array", "items": { "type": "object", "required": [ "title", "release_date", "age_rating", "runtime", "tomatometer", "audience_score", "poster_link", "fandango_link" ], "properties": { "title": { "type": "string", "description": "Movie title." }, "runtime": { "type": [ "string", "null" ], "description": "Runtime as displayed, such as 2 hr 25 min." }, "age_rating": { "type": [ "string", "null" ], "description": "Age rating, such as PG-13." }, "poster_link": { "type": [ "string", "null" ], "description": "Poster image link." }, "tomatometer": { "type": [ "integer", "null" ], "description": "Tomatometer score as a percent, if shown." }, "release_date": { "type": [ "string", "null" ], "description": "U.S. theatrical release date, if shown." }, "fandango_link": { "type": "string", "description": "Fandango movie page link." }, "audience_score": { "type": [ "integer", "null" ], "description": "Audience score as a percent, if shown." } } }, "description": "Movies in Fandango listing order." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
fandango.com/list_now_playing- Returns
- title, release date, age rating, runtime, tomatometer, audience score, poster, Fandango 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 fandango.com/list_now_playing with the inputs above.
Ask your agent
- What movies are showing in theaters right now? Give me the top 20 with their ratings and runtimes.
- Show me upcoming movie releases coming soon to theaters, with release dates and MPAA ratings.
- Pull Fandango's now playing list, up to 100 titles, including Rotten Tomatoes tomatometer and audience scores.
- Which films are hitting U.S. cinemas soon? I just need the next 10 with posters and links.
- On Fandango, what's currently in theaters? List the first 30 movies with their age ratings and how long each one runs.
See more
All Fandango methodsFinds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links.
fandango.com/get_movie_showtimesGets a movie theater's films and showtimes on Fandango for a date, from the theater's name and its city or ZIP code. Each film lists its rating, runtime and showtimes grouped by format with ticket links; a date without listed showtimes returns no films.
fandango.com/get_theater_showtimesLists Rotten Tomatoes movies in theaters, coming soon, or at home, by genre and site sort order, with scores, release dates, age ratings, posters and links.
rottentomatoes.com/list_moviesLists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score.
themoviedb.org/list_upcoming_moviesLists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members.
myanimelist.net/list_top_animeLists 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 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_chartsLists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates.
store.steampowered.com/list_top_sellers