Fandango API: Get theater showtimes
Gets 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.
Unofficial. Not affiliated with or endorsed by Fandango.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Date optional
date Showtime date in YYYY-MM-DD, such as 2026-09-29. Defaults to today in the theater's time zone.
2026-09-29
- Theater, required
theater The theater name, such as AMC Lincoln Square 13.
AMC Metreon 16
- Location, required
location The city and state or ZIP code, such as New York, NY or 10023.
San Francisco, CA
Input as JSON
{ "date": "2026-09-29", "theater": "AMC Metreon 16", "location": "San Francisco, CA"}Output
{ "date": "2026-09-29", "movies": [ { "title": "Princess Mononoke - Studio Ghibli Fest 2026", "runtime": "2 hr 18 min", "age_rating": "PG", "movie_link": "https://www.fandango.com/princess-mononoke-studio-ghibli-fest-2026-245499/movie-overview" , "showtime_groups": [ { "format": "Standard", "showtimes": [ { "date_time": "2026-09-29T19:00-07:00", "local_time": "7:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B19%3A00&from=mov_det_showtimes&source=desktop&mid=245499&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-451cfb34b1ef8b5a26ba221128a3ae77ced0a30e90fd91c841e77cc632ef3a68" }, { "date_time": "2026-09-29T20:00-07:00", "local_time": "8:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B20%3A00&from=mov_det_showtimes&source=desktop&mid=245499&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-52d07406bcc5d18f34b8e75d51004761144d0b1da860cba366a6bc38f52801ca" } ] } ] }, { "title": "Avengers Endgame: Encore (2026)", "runtime": "3 hr 5 min", "age_rating": "Not Rated", "movie_link": "https://www.fandango.com/avengers-endgame-encore-2026-246870/movie-overview" , "showtime_groups": [ { "format": "Premium Format", "showtimes": [ { "date_time": "2026-09-29T14:00-07:00", "local_time": "2:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B14%3A00&from=mov_det_showtimes&source=desktop&mid=246797&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-46d45e7235c56100c90b0343d85d727d4f404f4a29497bfdcc2f1184f8f57aad" }, { "date_time": "2026-09-29T13:00-07:00", "local_time": "1:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B13%3A00&from=mov_det_showtimes&source=desktop&mid=246797&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-f441f4e739e103dce5084b3b91adc9a159ff8475f626ee2f2b76a0189ddb4177" } ] }, { "format": "3D", "showtimes": [ { "date_time": "2026-09-29T15:00-07:00", "local_time": "3:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B15%3A00&from=mov_det_showtimes&source=desktop&mid=246871&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-5717ddb4940b1d2ace5d020be02f025d2aa14440ff322f9c3e92effbefd4b470" } ] }, { "format": "Standard", "showtimes": [ { "date_time": "2026-09-29T19:15-07:00", "local_time": "7:15 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B19%3A15&from=mov_det_showtimes&source=desktop&mid=246870&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-36be26b723637a9242efa8af0674244b1ab1fa4981cc6b6800f806502efdcdfd" }, { "date_time": "2026-09-29T21:45-07:00", "local_time": "9:45 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B21%3A45&from=mov_det_showtimes&source=desktop&mid=246870&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-c3c575a466ca70109c9ee7c3f221d918473b03f64b8ff209540a7521dc965ea0" } ] } ] }, { "title": "Charlie Harper (2026)", "runtime": "1 hr 42 min", "age_rating": "R", "movie_link": "https://www.fandango.com/charlie-harper-2026-247310/movie-overview" , "showtime_groups": [ { "format": "Standard", "showtimes": [ { "date_time": "2026-09-29T13:15-07:00", "local_time": "1:15 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B13%3A15&from=mov_det_showtimes&source=desktop&mid=247310&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-251583e0d92f41c04c4a2bf2ed1fc0ce33252bbe6d49e034e611402d934afce7" }, { "date_time": "2026-09-29T19:15-07:00", "local_time": "7:15 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B19%3A15&from=mov_det_showtimes&source=desktop&mid=247310&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-1d9bc3bdba8b0d45df25fe7d4038ab3421c22d7a903884e286d2e1b19737a962" } ] } ] } ], "address": "135 4th Street Suite #3000, San Francisco, CA 94103", "theater_name": "AMC Metreon 16", "fandango_link": "https://www.fandango.com/amc-metreon-16-aanem/theater-page" }Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"fandango.com/get_theater_showtimes","input":{"date":"2026-09-29","theater":"AMC Metreon 16","location":"San Francisco, CA"}}' # 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/get_theater_showtimes" , "input": { "date": "2026-09-29", "theater": "AMC Metreon 16", "location": "San Francisco, CA" }})# 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/get_theater_showtimes" , "input": { "date": "2026-09-29", "theater": "AMC Metreon 16", "location": "San Francisco, CA" } }), 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/get_theater_showtimes# with {"date":"2026-09-29","theater":"AMC Metreon 16","location":"San Francisco, CA"}"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": [ "theater", "location" ], "properties": { "date": { "type": "string", "description": "Showtime date in YYYY-MM-DD, such as 2026-09-29. Defaults to today in the theater's time zone." }, "theater": { "type": "string", "description": "The theater name, such as AMC Lincoln Square 13." }, "location": { "type": "string", "description": "The city and state or ZIP code, such as New York, NY or 10023." } }}Output schema
{ "type": "object", "required": [ "theater_name", "address", "fandango_link", "date", "movies" ], "properties": { "date": { "type": "string", "format": "date" }, "movies": { "type": "array", "items": { "type": "object", "required": [ "title", "age_rating", "runtime", "movie_link", "showtime_groups" ], "properties": { "title": { "type": "string" }, "runtime": { "type": [ "string", "null" ], "description": "Runtime as hours and minutes." }, "age_rating": { "type": [ "string", "null" ] }, "movie_link": { "type": [ "string", "null" ] }, "showtime_groups": { "type": "array", "items": { "type": "object", "required": [ "format", "showtimes" ], "properties": { "format": { "type": "string" }, "showtimes": { "type": "array", "items": { "type": "object", "required": [ "local_time", "date_time", "ticket_link" ], "properties": { "date_time": { "type": "string", "description": "Local showtime as ISO 8601 with UTC offset." }, "local_time": { "type": "string", "description": "Local showtime as displayed in 12-hour time." }, "ticket_link": { "type": [ "string", "null" ], "description": "Fandango ticket link, if available." } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "additionalProperties": false } }, "address": { "type": "string" }, "theater_name": { "type": "string" }, "fandango_link": { "type": "string" } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
fandango.com/get_theater_showtimes- Returns
- theater name, address, Fandango link, date; movies with title, age rating, runtime, link and showtime groups (format, local time, ISO date-time, ticket 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/get_theater_showtimes with the inputs above.
Ask your agent
- What's playing at Regal Union Square in New York, NY on 2026-03-14, and what are the showtimes?
- Pull Fandango showtimes for Alamo Drafthouse South Lamar, 78704, this Friday 2025-11-07 with ticket links
- Showtimes today at AMC Metreon 16 in San Francisco — I want to know which movies are in IMAX and their runtimes
- Using fandango.com, list all films and screening times at Cinemark Tinseltown in Pflugerville, TX for December 20, 2025
- Can you check the movie schedule for Harkins Camelview at Fashion Square, Scottsdale AZ, on 2026-01-02? Include ratings and formats like Dolby or 3D.
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_showtimesLists 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.
fandango.com/list_now_playingLists 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_moviesFinds 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_movieReturns the domestic US and Canada daily box office rankings for a date, or the latest reported day when no date is given.
boxofficemojo.com/get_daily_box_officeFinds upcoming Ticketmaster-listed concerts, sports, theater and other events by keyword, optionally by city, country, category and date range, with dates, venues, prices when shown and links. Partner-only listings without a Ticketmaster link are excluded; very large searches cover only the first 800 listings.
ticketmaster.com/search_eventsLists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone.
mlb.com/get_scoresLists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks.
nhl.com/get_scores