# Rotten Tomatoes Scraper (`anyxsolutions/rotten-tomatoes-scraper`) Actor Scrape Rotten Tomatoes movies and TV shows from title pages or browse grids: Tomatometer and Popcornmeter scores with counts, Certified Fresh, critics consensus, cast, crew, genres, runtime, box office, release dates and where to watch, plus critic and audience reviews. No login. - **URL**: https://apify.com/anyxsolutions/rotten-tomatoes-scraper.md - **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community) - **Categories:** Social media, Other - **Security:** Limited permissions - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ![banner](https://anyx.solutions/banners/rotten-tomatoes-scraper.png) ## Rotten Tomatoes Scraper **Movies and TV shows from Rotten Tomatoes — Tomatometer and Popcornmeter scores, Certified Fresh, critics consensus, cast, crew, box office and where to watch — from title pages and browse grids, as clean JSON.** Rotten Tomatoes is where audiences check what critics and fellow viewers think before they buy a ticket or press play, which makes its scores one of the most watched signals in entertainment. This Actor scrapes Rotten Tomatoes movies and TV shows from title pages or browse grids and returns one record per title: the Tomatometer and Popcornmeter scores with their counts and averages, the Certified Fresh and Verified Hot badges, the Top Critics score, the critics consensus, title, year, rating and its reasons, genres, runtime, original language, theatrical and streaming release dates, director, writers, producers, distributor and production companies, US box office, synopsis, top-billed cast with characters, the poster and trailer, and where to watch, plus seasons and episodes for TV. Paste movie, series or season pages, or a browse page such as Popular Movies at Home with any filters; switch on reviews to add the critic and audience reviews shown on each title's page. No login. Built for studios, distributors and streaming teams, entertainment marketers and analysts, data journalists, and anyone building on film and TV data. ### ⚡ Quick start ```json { "startUrls": [ { "url": "https://www.rottentomatoes.com/browse/movies_at_home/sort:popular" } ], "maxItems": 5 } ``` Or a movie and a TV season, with their reviews: ```json { "startUrls": [ { "url": "https://www.rottentomatoes.com/m/parasite_2019" }, { "url": "https://www.rottentomatoes.com/tv/the_bear/s01" } ], "includeReviews": true, "reviewType": "top_critics" } ``` ### 🧩 Input | Field | Type | Required | Default | Description | | -------------------- | ------- | -------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array | yes | — | Rotten Tomatoes pages: a movie (`/m/parasite_2019`), a TV series (`/tv/the_bear`) or season (`/tv/the_bear/s01`), or a browse page with any filters (`/browse/movies_at_home/sort:popular`, `/browse/movies_in_theaters/genres:comedy`, `/browse/tv_series_browse/affiliates:netflix~sort:popular`, `/browse/movies_coming_soon`). | | `includeReviews` | boolean | no | `false` | Add the critic and audience reviews shown on each title's page. Adds no extra pages to the run. | | `reviewType` | string | no | `all` | Which reviews to add: `all` (critics and audience), `critics`, `top_critics` or `audience`. | | `maxReviews` | integer | no | `6` | Critic reviews and audience reviews to add per title, from 1 to 6 each (a title page shows up to 6 of each). | | `maxItems` | integer | no | — | Maximum number of titles per start URL. The input form starts at 5; leave it empty to get every title on a browse page. | | `proxyConfiguration` | object | no | `{ "useApifyProxy": false }` | Proxy settings. Rotten Tomatoes' public pages work without a proxy. | **Which pages work.** Movie, series and season pages, and the four browse grids (Movies in Theaters, Movies at Home, Coming Soon, TV Shows) with any combination of filters and sort order. Links to a title's sub-pages (reviews, cast and crew, an episode) resolve to the movie, series or season itself. Browse grids are read page by page until `maxItems` is reached. Search results are not supported: paste the title or a filtered browse page instead. ### 📤 Output Each movie, series or season is one dataset row. Titles from a browse page keep the grid's order and carry their position as `listRank`. `reviews` is `null` unless `includeReviews` is on. #### Fields | Field | Type | Description | | --------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `url` | string | The title page on Rotten Tomatoes. | | `slug` | string | The title's path on Rotten Tomatoes, e.g. `parasite_2019` or `the_bear/s01`. | | `mediaType` | string | `movie`, `tvSeries` or `tvSeason`. | | `emsId` | string | Rotten Tomatoes' internal ID for the title. | | `title` | string | Title as Rotten Tomatoes shows it (for a season, e.g. `Season 1`). | | `seriesTitle` | string | For a season, the series it belongs to; `null` otherwise. | | `seasonNumber` | number | For a season, its number; `null` otherwise. | | `year` | number | Release year (first year for a series). | | `contentRating` | string | MPAA or TV rating, e.g. `R` or `TV-MA`. | | `contentRatingReasons` | array | The reasons given for the rating, e.g. `Language`. | | `genres` | array | Genres. | | `runtimeMinutes` | number | Running time in minutes (movies). | | `originalLanguage` | string | Original language. | | `releaseDate` | string | Release date, `YYYY-MM-DD`: the premiere for TV, the theatrical (or else streaming) release for movies. | | `releaseDateTheaters` | string | Theatrical release date, `YYYY-MM-DD`. | | `releaseDateStreaming` | string | Streaming release date, `YYYY-MM-DD`. | | `directors` | array | Directors. | | `writers` | array | Screenwriters. | | `producers` | array | Producers and executive producers. | | `creators` | array | Series creators (TV). | | `distributors` | array | Distributors (movies). | | `productionCompanies` | array | Production companies (movies). | | `networks` | array | Networks or streaming services that air the show (TV). | | `boxOffice` | string | US box office gross as shown, e.g. `$53.7M`. | | `boxOfficeUsd` | number | US box office gross in dollars. | | `synopsis` | string | Plot summary. | | `criticsConsensus` | string | Rotten Tomatoes' summary of what critics said. | | `tomatometer` | number | Tomatometer score, 0 to 100: the share of critic reviews that are positive. | | `tomatometerReviewsCount` | number | Critic reviews counted in the Tomatometer. | | `tomatometerFreshCount` | number | Fresh (positive) critic reviews. | | `tomatometerRottenCount` | number | Rotten (negative) critic reviews. | | `tomatometerAverageRating` | number | Average critic rating, out of 10. | | `certifiedFresh` | boolean | True when the title holds the Certified Fresh badge. | | `topCriticsTomatometer` | number | Tomatometer among Top Critics only. | | `topCriticsReviewsCount` | number | Top Critic reviews counted. | | `popcornmeter` | number | Popcornmeter (audience score), 0 to 100: the share of audience ratings that are positive. | | `popcornmeterType` | string | `verified` when the score counts verified ticket buyers only, `all` when it counts every rating. | | `popcornmeterRatingsCount` | number | Audience ratings counted in the Popcornmeter. | | `popcornmeterRatingsBand` | string | The rating count as Rotten Tomatoes shows it, e.g. `5,000+ Verified Ratings`. | | `popcornmeterAverageRating` | number | Average audience rating, out of 5. | | `verifiedHot` | boolean | True when the title holds the Verified Hot badge. | | `allAudiencePopcornmeter` | number | Popcornmeter across all audience ratings, verified or not. | | `allAudienceRatingsCount` | number | Audience ratings counted in `allAudiencePopcornmeter`. | | `cast` | array | Top-billed cast: `name`, `character` and `url`. | | `posterUrl` | string | Poster image. | | `trailerUrl` | string | The trailer's page on Rotten Tomatoes. | | `whereToWatch` | array | Where to watch: `provider`, `label`, `url` and, for TV, `availableSeasons`. | | `whereToWatchSummary` | string | Rotten Tomatoes' one-line summary of where to watch. | | `numberOfSeasons` | number | For a series, how many seasons it has. | | `seasons` | array | For a series, its seasons: `title` and `url`. | | `numberOfEpisodes` | number | For a season, how many episodes it has. | | `episodes` | array | For a season, its episodes: `episodeNumber`, `title`, `url`, `airDate` and `synopsis`. | | `listRank` | number | The title's position on the browse page it came from; `null` otherwise. | | `sourceUrl` | string | The page the title was found on (the title page itself for a pasted title). | | `reviews` | array | Reviews shown on the title page: `reviewType` (`critic` or `audience`), `reviewId`, `author`, `authorUrl`, `publication`, `publicationUrl`, `isTopCritic`, `isVerified`, `sentiment` (`fresh` or `rotten`), `rating`, `originalScore`, `text`, `date` and `url`. |
Example output ```json { "url": "https://www.rottentomatoes.com/m/parasite_2019", "slug": "parasite_2019", "mediaType": "movie", "emsId": "a82538f5-e84b-32e8-9a49-2872b563d583", "title": "Parasite", "seriesTitle": null, "seasonNumber": null, "year": 2019, "contentRating": "R", "contentRatingReasons": ["Sexual Content", "Language", "Some Violence"], "genres": ["Comedy", "Mystery & Thriller", "Drama"], "runtimeMinutes": 132, "originalLanguage": "Korean", "releaseDate": "2019-11-01", "releaseDateTheaters": "2019-11-01", "releaseDateStreaming": "2019-10-11", "directors": ["Bong Joon Ho"], "writers": ["Han Jinwon"], "producers": ["Kwak Sin-ae", "Moon Yanggwon"], "creators": [], "distributors": ["NEON"], "productionCompanies": ["CJ Entertainment"], "networks": [], "boxOffice": "$53.7M", "boxOfficeUsd": 53700000, "synopsis": "Greed and class discrimination threaten the newly formed symbiotic relationship between the wealthy Park family and the destitute Kim clan.", "criticsConsensus": "An urgent, brilliantly layered look at timely social themes, Parasite finds writer-director Bong Joon Ho in near-total command of his craft.", "tomatometer": 99, "tomatometerReviewsCount": 484, "tomatometerFreshCount": 477, "tomatometerRottenCount": 7, "tomatometerAverageRating": 9.4, "certifiedFresh": true, "topCriticsTomatometer": 100, "topCriticsReviewsCount": 81, "popcornmeter": 90, "popcornmeterType": "verified", "popcornmeterRatingsCount": 7538, "popcornmeterRatingsBand": "5,000+ Verified Ratings", "popcornmeterAverageRating": 4.5, "verifiedHot": true, "allAudiencePopcornmeter": 91, "allAudienceRatingsCount": 28124, "cast": [ { "name": "Song Kang-ho", "character": "Kim Ki-taek", "url": "https://www.rottentomatoes.com/celebrity/kangho_song" }, { "name": "Lee Sun-kyun", "character": "Park Dong-ik", "url": "https://www.rottentomatoes.com/celebrity/lee_sun_gyun" }, { "name": "Cho Yeo-jeong", "character": "Choi Yeon-gyo", "url": "https://www.rottentomatoes.com/celebrity/yeojeong_jo" }, { "name": "Choi Woo-sik", "character": "Kim Ki-woo", "url": "https://www.rottentomatoes.com/celebrity/choi_usik" }, { "name": "Park So-dam", "character": "Kim Ki-jung", "url": "https://www.rottentomatoes.com/celebrity/park_so_dam" } ], "posterUrl": "https://resizing.flixster.com/0nQ2niq2j-E4gdW_kB5H606atmc=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzLzZlZWEwMmY4LTk1OWUtNGEyOS04ODRmLTA0OWRjMzhlYWZkNi53ZWJw", "trailerUrl": "https://www.rottentomatoes.com/m/parasite_2019/videos/rXKzGClMxf5Z", "whereToWatch": [ { "provider": "fandango", "label": "Stream", "url": "https://athome.fandango.com/content/browse/details/Parasite/1265095?cmp=rt_where_to_watch", "availableSeasons": null }, { "provider": "paramount-plus-us", "label": "Paramount+", "url": "https://paramountplus.qflm.net/c/3465016/175360/3065?cmp=rt_where_to_watch", "availableSeasons": null } ], "whereToWatchSummary": "Watch Parasite with a subscription on Paramount+, rent on Fandango, or buy on Fandango.", "numberOfSeasons": null, "seasons": null, "numberOfEpisodes": null, "episodes": null, "listRank": null, "sourceUrl": "https://www.rottentomatoes.com/m/parasite_2019", "reviews": [ { "reviewType": "critic", "reviewId": null, "author": "Clarisse Loughrey", "authorUrl": "https://www.rottentomatoes.com/critic/clarisse-loughrey", "publication": "Independent (UK)", "publicationUrl": "https://www.rottentomatoes.com/profiles/publication/e8y8pvy2", "isTopCritic": true, "isVerified": null, "sentiment": "fresh", "rating": null, "originalScore": "5/5", "text": "[Bong Joon-ho]'s work is as playful as it is sincere and revelatory. He'll make you feel at home, and then rip the rug out from under you.", "date": "2020-02-12", "url": "https://www.independent.co.uk/arts-entertainment/films/reviews/parasite-review-bong-joon-ho-cast-director-oscars-2020-best-picture-a9319656.html" }, { "reviewType": "audience", "reviewId": "ca027e9e-7a47-4e2b-8332-baa583ce1a39", "author": "Zion", "authorUrl": null, "publication": null, "publicationUrl": null, "isTopCritic": null, "isVerified": true, "sentiment": null, "rating": 5, "originalScore": null, "text": "Filmmaking at its peak", "date": "2026-03-28", "url": null } ] } ```
### 💡 Use cases - **Release tracking** — follow how a new movie or season scores with critics and audiences week by week, and when it turns Certified Fresh. - **Acquisition and programming research** — rank a filtered browse page, such as the best comedies on a streaming service, by Tomatometer and Popcornmeter before licensing. - **Entertainment marketing** — compare a title's critic and audience scores, consensus and box office with its competition. - **Data products and journalism** — build datasets of scores, credits, release dates and where to watch across thousands of titles. ### ❓ FAQ - **Do I need a Rotten Tomatoes account?** No. The Actor reads the same public pages anyone can open. - **Do I need a proxy?** No. It runs without one by default. - **How many reviews can I get per title?** Up to 6 critic reviews and 6 audience reviews: the ones Rotten Tomatoes shows on the title's own page, with the critic's verdict, outlet and a link to the full review. - **Why is the Popcornmeter sometimes "verified" and sometimes "all"?** For movies released in US theaters, Rotten Tomatoes scores only verified ticket buyers; other titles count every rating. `popcornmeterType` tells you which, and `allAudiencePopcornmeter` always gives the all-ratings score. - **Why are the scores empty for some titles?** Upcoming titles, and titles with too few reviews, have no Tomatometer or Popcornmeter yet; those fields are `null`. - **Can I search by title?** No. Paste the title's page, or a browse page filtered by genre, service or rating. ### 🔗 More scrapers by Anyx - [Letterboxd Scraper](https://apify.com/anyxsolutions/letterboxd-scraper) - [Goodreads Scraper](https://apify.com/anyxsolutions/goodreads-scraper) - [Steam Scraper](https://apify.com/anyxsolutions/steam-scraper) - [Trustpilot Scraper](https://apify.com/anyxsolutions/trustpilot-scraper) ### 🤝 Anyx Solutions We build custom scrapers and data-extraction pipelines. - Email: tantosthor@gmail.com ### 🖼 Image credit Image credit: [rottentomatoes.com](https://www.rottentomatoes.com/) # Actor input Schema ## `startUrls` (type: `array`): Rotten Tomatoes pages to scrape, such as a movie (https://www.rottentomatoes.com/m/parasite_2019), a TV series or season (https://www.rottentomatoes.com/tv/the_bear/s01), or a browse page with any filters (https://www.rottentomatoes.com/browse/movies_at_home/sort:popular). ## `includeReviews` (type: `boolean`): Add the critic and audience reviews shown on each title's page, for example to read what critics said about a release. Adds no extra pages to the run. ## `reviewType` (type: `string`): Which reviews to add when reviews are on, for example only Top Critics. ## `maxReviews` (type: `integer`): How many critic reviews and how many audience reviews to add per title when reviews are on, for example 3. A title page shows up to 6 of each. ## `maxItems` (type: `integer`): Maximum number of titles to return per start URL. Leave empty to get every title on a browse page. ## `proxyConfiguration` (type: `object`): Proxy settings. Rotten Tomatoes' public pages work without a proxy. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.rottentomatoes.com/browse/movies_at_home/sort:popular" } ], "includeReviews": false, "reviewType": "all", "maxReviews": 6, "maxItems": 5, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.rottentomatoes.com/browse/movies_at_home/sort:popular" } ], "maxItems": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("anyxsolutions/rotten-tomatoes-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.rottentomatoes.com/browse/movies_at_home/sort:popular" }], "maxItems": 5, } # Run the Actor and wait for it to finish run = client.actor("anyxsolutions/rotten-tomatoes-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.rottentomatoes.com/browse/movies_at_home/sort:popular" } ], "maxItems": 5 }' | apify call anyxsolutions/rotten-tomatoes-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,anyxsolutions/rotten-tomatoes-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/wU2cgj4dC2jcybkuK/builds/STMW1bOHvne5L7GrM/openapi.json