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

{
  "startUrls": [
    {
      "url": "https://www.rottentomatoes.com/browse/movies_at_home/sort:popular"
    }
  ],
  "maxItems": 5
}

Or a movie and a TV season, with their reviews:

{
  "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.

💡 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
• Goodreads Scraper
• Steam Scraper
• Trustpilot Scraper

🤝 Anyx Solutions

We build custom scrapers and data-extraction pipelines.

• Email: tantosthor@gmail.com

🖼 Image credit

Image credit: rottentomatoes.com