# Rotten Tomatoes API: List movies > 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. Unofficial. Not affiliated with or endorsed by Rotten Tomatoes. - Page: https://fous.com/methods/rottentomatoes.com/list-movies - Method: `rottentomatoes.com/list_movies`, version 1 - Website: rottentomatoes.com - Returns: title, tomatometer, popcornmeter, release_date, age_rating, poster_url, rotten_tomatoes_url - 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 browse, for example in_theaters. One of "in_theaters", "coming_soon", "at_home". Default "in_theaters". | | `sort` | string | no | | Movie order, for example highest_tomatometer. One of "popular", "newest", "highest_tomatometer". Default "popular". | | `genre` | string | no | | A genre such as comedy, horror, or all for every genre. Default "all". | | `max_results` | integer | no | | Maximum number of movies to return, for example 30. Default 30. | ## Output From a run on Oct 27, 2026, shortened. Its input: ```json {} ``` Its output: ```json { "movies": [ { "title": "Clayface", "age_rating": "R", "poster_url": "https://resizing.flixster.com/8_nzAOUQI30pSRAcyNqfdWAUe4w=/164x246/v2/https://resizing.flixster.com/O8G8HZEBw1uKp4Sc2X4VFjg0KUI=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzL2M0MzFlZWJlLTc1NWUtNGQ0YS1iYjc5LTZlZTRhZTBhNWU5YS5qcGc=", "tomatometer": 76, "popcornmeter": 94, "release_date": "2026-10-23", "rotten_tomatoes_url": "https://www.rottentomatoes.com/m/clayface" }, { "title": "Wildwood", "age_rating": "PG-13", "poster_url": "https://resizing.flixster.com/gPNZYWtyMODaicuGSxJEszbGq1I=/164x246/v2/https://resizing.flixster.com/HpkfBndrOSDT-UQdWbwK7oq3Sc8=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzk5Nzk1ZGRkLTdkOGMtNDZmMy1hNzk4LTg4ZmYwODU2M2ViMi5qcGc=", "tomatometer": 99, "popcornmeter": 97, "release_date": "2026-10-23", "rotten_tomatoes_url": "https://www.rottentomatoes.com/m/wildwood" }, { "title": "Street Fighter", "age_rating": "PG-13", "poster_url": "https://resizing.flixster.com/KMI97W_98kuvqFjO7WIlnYG8Th4=/164x246/v2/https://resizing.flixster.com/HI64aC1g5q3IEbUvYxwC7aD2k8E=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzBmZTYzOGEwLTRjMTQtNDcxYS1hMzY3LTUwOTI5OGQ1OTI0Ny5qcGc=", "tomatometer": 41, "popcornmeter": 78, "release_date": "2026-10-16", "rotten_tomatoes_url": "https://www.rottentomatoes.com/m/street_fighter_2026" } ] } ``` ## 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":"rottentomatoes.com/list_movies","input":{}}' ``` 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 - Show me the movies currently playing in theaters sorted by highest tomatometer score, limit to 15 - What horror films are coming soon? Include release dates and age ratings - Browse at-home movies in the comedy genre ranked by popularity, give me the top 25 - List the newest films out right now on Rotten Tomatoes with their popcornmeter scores - I want a list of upcoming movies with posters and links, all genres, up to 40 results ## Input schema ```json { "type": "object", "properties": { "list": { "enum": [ "in_theaters", "coming_soon", "at_home" ], "type": "string", "default": "in_theaters", "description": "Which movie list to browse, for example in_theaters." }, "sort": { "enum": [ "popular", "newest", "highest_tomatometer" ], "type": "string", "default": "popular", "description": "Movie order, for example highest_tomatometer." }, "genre": { "type": "string", "default": "all", "description": "A genre such as comedy, horror, or all for every genre." }, "max_results": { "type": "integer", "default": 30, "maximum": 100, "minimum": 1, "description": "Maximum number of movies to return, for example 30." } } } ``` ## Output schema ```json { "type": "object", "required": [ "movies" ], "properties": { "movies": { "type": "array", "items": { "type": "object", "required": [ "title", "tomatometer", "popcornmeter", "release_date", "age_rating", "poster_url", "rotten_tomatoes_url" ], "properties": { "title": { "type": "string", "description": "Movie title." }, "age_rating": { "type": [ "string", "null" ], "description": "Age classification, or null if not listed." }, "poster_url": { "type": [ "string", "null" ], "description": "Poster image link, or null if unavailable." }, "tomatometer": { "type": [ "integer", "null" ], "description": "Critics score as a percent, or null if unavailable." }, "popcornmeter": { "type": [ "integer", "null" ], "description": "Audience score as a percent, or null if unavailable." }, "release_date": { "type": [ "string", "null" ], "format": "date", "description": "Theatrical release date, or streaming release date for at-home movies." }, "rotten_tomatoes_url": { "type": "string", "description": "Rotten Tomatoes movie page." } }, "additionalProperties": false }, "description": "Movies in the selected site order." } }, "additionalProperties": false } ``` ## See more - [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets 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. - [Rotten Tomatoes API: Get reviews](https://fous.com/methods/rottentomatoes.com/get-reviews.md): Reads the newest critic or audience reviews for a Rotten Tomatoes movie or TV show. For a whole TV show it combines reviews from its seasons. - [Fandango API: List movies now playing or coming soon](https://fous.com/methods/fandango.com/list-now-playing.md): 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. - [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. - [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. - [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. - [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. - [Metacritic API: List best-reviewed titles](https://fous.com/methods/metacritic.com/list-best-reviewed.md): Lists the highest-Metascore games, movies or TV shows on Metacritic for a release year or all time. You can filter by genre, and by platform for games. - [All Rotten Tomatoes methods](https://fous.com/methods/rottentomatoes.com.md)