# 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. - Page: https://fous.com/methods/fandango.com/list-now-playing - Method: `fandango.com/list_now_playing`, version 1 - Website: fandango.com - Returns: title, release date, age rating, runtime, tomatometer, audience score, poster, Fandango 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 | |---|---|---|---|---| | `list` | string | no | | Which movie list to show, for example now_playing. One of "now_playing", "coming_soon". Default "now_playing". | | `max_results` | integer | no | `50` | Maximum movies to return, for example 50. Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "max_results": 50 } ``` Its output: ```json { "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 } ] } ``` ## 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":"fandango.com/list_now_playing","input":{"max_results":50}}' ``` 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 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. ## Input schema ```json { "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 ```json { "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." } } } ``` ## See more - [Fandango API: Get movie showtimes](https://fous.com/methods/fandango.com/get-movie-showtimes.md): Finds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links. - [Fandango API: Get theater showtimes](https://fous.com/methods/fandango.com/get-theater-showtimes.md): 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. - [Rotten Tomatoes API: List movies](https://fous.com/methods/rottentomatoes.com/list-movies.md): Lists 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. - [themoviedb.org API: List upcoming theatrical movies in a country](https://fous.com/methods/themoviedb.org/list-upcoming-movies.md): Lists 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. - [MyAnimeList API: List top anime](https://fous.com/methods/myanimelist.net/list-top-anime.md): Lists 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. - [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. - [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. - [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates. - [All Fandango methods](https://fous.com/methods/fandango.com.md)