Rotten Tomatoes Scraper - Movie & TV Ratings

🍅 Rotten Tomatoes scores and reviews for film research

Film researchers, catalog teams, and developers can collect public Rotten Tomatoes movie, TV series, and season data in structured rows. Get available Tomatometer and audience scores, cast, credits, and title details, or collect critic and audience reviews. Use the data to compare scores, add facts to a catalog, or study audience feedback without copying each page by hand.

• Look up title details for The Super Mario Galaxy Movie for your film research.
• Collect The Flash Cast to add actor names and roles to your catalog.
• Save Rotten Tomatoes Critic Reviews to study published feedback.
• Collect Rotten Tomatoes Audience Reviews to study viewer feedback.
• Compare season scores with Rotten Tomatoes TV Season Ratings.

📦 Movie, TV, and review data

Title rows identify the actual source title and its Rotten Tomatoes URL. They can include scores, review counts, a synopsis, cast, credits, release dates, and artwork links. Series scores and season scores stay tied to their own title pages.

Review rows hold one public critic or audience review. They can include text, a rating or original score, dates, reviewer details, and source flags. Optional fields appear when the source provides them. Image and review links are references, not downloaded files.

The first eligible occurrence of each source item is saved. Later matches from another keyword or URL are ignored and do not add data to the saved row.

▶️ Choose title details or reviews

1. Choose Titles for title facts and scores, or Reviews for individual reviews.
2. For Titles, enter keywords, Rotten Tomatoes URLs, or both. Choose movies, TV, or both for keyword search.
3. For Reviews, enter movie or TV-season URLs and choose critic, audience, or both. Set the Top Critics or verified-audience filters if needed.
4. Set maxItems to limit saved rows across the run. Leave it empty to return all available results until the source is exhausted.
5. Start the run and open the dataset from the Output tab.

Keyword search does not guarantee an exact title match. Use a title URL when you know which page you want. Options for the other result type are ignored.

⚙️ Input

Input fields

Field	Type	What it does
resultType	string	Required. Choose titles for movie, TV series, and season details, or reviews for individual reviews. The form starts with titles.
keywords	array of strings	Search terms for Titles, one per line. Can be used with URLs.
mediaType	string	Limits keyword search to movies, tv, or both. Default: both. Does not limit submitted URLs.
includeSearchAlternatives	boolean	Collects all matching titles from keyword search. Default: true. Turn off to collect only the first match per keyword. Search does not guarantee an exact match.
reviewType	string	For Reviews, choose critic, audience, or both. Default: critic. This choice also applies to URLs with review query parameters or fragments.
topCriticsOnly	boolean	Collects only critic reviews marked as Top Critic reviews. Applies to critic reviews even when both is selected. Default: false.
verifiedAudienceOnly	boolean	Collects only audience reviews marked as verified. Applies to audience reviews even when both is selected. Default: false.
startUrls	array of strings	Rotten Tomatoes movie, TV series, season, review, or credits addresses, one per line. Full URLs and paths such as /m/the_matrix are accepted. Titles accepts keywords, URLs, or both. Reviews needs URLs; reviewType sets whose reviews to collect.
maxItems	integer	Optional positive limit on title or review rows across the run. Leave it empty to return all available results until the source is exhausted. The form pre-fills 10; there is no fixed upper bound.

Successful default input

This public input is from a successful run:

{
  "resultType": "titles",
  "mediaType": "both",
  "includeSearchAlternatives": true,
  "reviewType": "critic",
  "topCriticsOnly": false,
  "verifiedAudienceOnly": false,
  "startUrls": [
    "https://www.rottentomatoes.com/m/the_matrix"
  ],
  "maxItems": 10
}

🧾 Output

The results output link opens the collected dataset. The tables cover title and review rows. Dotted paths show nested fields, including fields inside array entries. Fields other than each shape's required fields can be absent.

Title rows

Movies, TV series, and seasons share this shape. Required fields are rowType, title, url, and mediaType.

Field	Type	What it does
rowType	string	Always title.
title	string	Movie, TV series, or season name.
url	string	Rotten Tomatoes title URL.
mediaType	string	movie, tv, or season.
releaseYear	integer	Published release year.
sourceId	string	Rotten Tomatoes title ID.
synopsis	string	Published plot summary.
genres	array of strings	Genres listed for the title.
contentRating	string	Published content rating.
runtime	string	Running time as shown by the source.
originalLanguage	string	Original language.
releaseStatus	string	Source release status.
criticRating	object	Available critic score and review details.
criticRating.score	number	Tomatometer score from 0 to 100.
criticRating.averageRating	string	Source average rating, with its scale when given.
criticRating.sentiment	string	Source score label.
criticRating.certification	string	Source certification.
criticRating.consensus	string	Published critics consensus.
criticRating.reviewCountLabel	string	Source review-count label.
criticRating.positiveReviewCount	integer	Published positive critic review count.
audienceRating	object	Available audience score and review details.
audienceRating.score	number	Audience score from 0 to 100.
audienceRating.averageRating	string	Source average rating, with its scale when given.
audienceRating.sentiment	string	Source score label.
audienceRating.certification	string	Source certification.
audienceRating.consensus	string	Source review summary.
audienceRating.reviewCountLabel	string	Approximate source review-volume label. Exact counts are not repeated here.
audienceRating.positiveReviewCount	integer	Published positive audience review count.
topCriticRating	object	Available Top Critics score and review volume.
topCriticRating.score	number	Published Top Critics score from 0 to 100.
topCriticRating.positiveReviewCount	integer	Published positive Top Critic review count.
cast	array of objects	Available featured cast credits.
cast.name	string	Cast member name. Required in each cast entry.
cast.role	string	Credited role or character.
cast.url	string	Source profile URL.
directors	array of strings	Named directors.
producers	array of strings	Named producers.
writers	array of strings	Named writers.
creators	array of strings	Named TV series creators.
distributor	string	Named distributor.
productionCompanies	array of strings	Named production companies.
network	string	Named TV network.
releaseDates	object	Published release dates.
releaseDates.theatrical	string	Theater release date as shown.
releaseDates.streaming	string	Streaming release date as shown.
releaseDates.premiere	string	TV series or season premiere date as shown.
releaseDates.rerelease	string	Theater rerelease date as shown.
boxOffice	string	Published US box-office gross, with currency and units.
soundMix	array of strings	Published sound formats.
aspectRatio	string	Published aspect ratio.
artworkUrl	string	Source artwork URL.
seasons	array of objects	Seasons listed on a TV series page.
seasons.name	string	Season name. Required in each season entry.
seasons.url	string	Season title URL. Required in each season entry.

Example title row

This complete row is from a successful run:

{
  "rowType": "title",
  "title": "The Matrix",
  "url": "https://www.rottentomatoes.com/m/matrix",
  "mediaType": "movie",
  "releaseYear": 1999,
  "synopsis": "Neo believes that Morpheus, an elusive figure considered to be the most dangerous man alive, can answer his question -- What is the Matrix? Neo is contacted by Trinity, a beautiful stranger who leads him into an underworld where he meets Morpheus. They fight a brutal battle for their lives against a cadre of viciously intelligent secret agents. It is a truth that could cost Neo something more precious than his life.",
  "genres": [
    "Sci-Fi",
    "Action",
    "Mystery & Thriller"
  ],
  "contentRating": "R",
  "runtime": "2h 16m",
  "cast": [
    {
      "name": "Keanu Reeves",
      "url": "https://www.rottentomatoes.com/celebrity/keanu_reeves",
      "role": "Thomas \"Neo\" Anderson"
    },
    {
      "name": "Laurence Fishburne",
      "url": "https://www.rottentomatoes.com/celebrity/larry_fishburne",
      "role": "Morpheus"
    },
    {
      "name": "Carrie-Anne Moss",
      "url": "https://www.rottentomatoes.com/celebrity/carrie_anne_moss",
      "role": "Trinity"
    },
    {
      "name": "Hugo Weaving",
      "url": "https://www.rottentomatoes.com/celebrity/hugo_weaving",
      "role": "Agent Smith"
    }
  ],
  "directors": [
    "Lilly Wachowski",
    "Lana Wachowski"
  ],
  "producers": [
    "Joel Silver"
  ],
  "artworkUrl": "https://resizing.flixster.com/hTz9Ap43sCkvDiFvCkjmb1IWkUg=/ems.cHJkLWVtcy1hc3NldHMvbW92aWVzL2EwMGEwNmQxLTE1MGYtNGQwYS04ZDhlLWQ0MzYwOTQ5M2JlMC5qcGc=",
  "criticRating": {
    "score": 83,
    "reviewCountLabel": "209 Reviews",
    "positiveReviewCount": 173,
    "averageRating": "7.90",
    "sentiment": "POSITIVE",
    "certification": "certified",
    "consensus": "Thanks to the Wachowskis' imaginative vision, The Matrix is a smartly crafted combination of spectacular action and groundbreaking special effects."
  },
  "audienceRating": {
    "score": 85,
    "reviewCountLabel": "250,000+ Ratings",
    "positiveReviewCount": 142778,
    "averageRating": "3.6",
    "sentiment": "POSITIVE"
  },
  "releaseDates": {
    "theatrical": "Mar 31, 1999, Wide",
    "streaming": "Jan 1, 2009",
    "rerelease": "Sep 19, 2024"
  },
  "releaseStatus": "OUT_OF_THEATERS",
  "originalLanguage": "English",
  "distributor": "Warner Bros. Pictures",
  "productionCompanies": [
    "Warner Bros.",
    "Village Roadshow Prod.",
    "Silver Pictures"
  ],
  "boxOffice": "$171.4M",
  "soundMix": [
    "Dolby Stereo",
    "DTS",
    "SDDS",
    "Surround",
    "Dolby Digital",
    "Dolby SR"
  ],
  "aspectRatio": "Scope (2.35:1)",
  "sourceId": "c8afce97-a899-3ba6-a919-a3a1e2608fba",
  "topCriticRating": {
    "score": 71,
    "positiveReviewCount": 41
  }
}

Review rows

Critic and audience reviews share this shape. Required fields are rowType, title, url, mediaType, and reviewType. Each row also has at least one of reviewText, rating, or originalScore.

Field	Type	What it does
rowType	string	Always review.
title	string	Reviewed movie or TV title name.
url	string	Rotten Tomatoes title URL.
mediaType	string	movie, tv, or season.
releaseYear	integer	Published title release year.
reviewType	string	critic or audience.
reviewId	string	Source review ID.
reviewText	string	Source review text with HTML entities shown as readable characters.
rating	number	Audience rating on the source scale.
originalScore	string	Critic's original score, with its scale when given.
sentiment	string	Source review sentiment.
createdAt	string	Source review creation date.
updatedAt	string	Source review update date.
reviewer	object	Available reviewer details.
reviewer.name	string	Reviewer name.
reviewer.imageUrl	string	Source critic profile image URL.
publication	object	Available critic publication details.
publication.name	string	Publication name.
publication.url	string	Source publication URL.
publication.imageUrl	string	Source publication image URL.
reviewUrl	string	Critic's full review URL on the publication's site.
isTopCritic	boolean	Whether the source marks the reviewer as a Top Critic.
isVerified	boolean	Whether the source marks the audience review as verified.
isSuperReviewer	boolean	Whether the source marks the reviewer as a super-reviewer.
hasSpoilers	boolean	Whether the source marks the review as containing spoilers.
hasProfanity	boolean	Whether the source marks the review as containing profanity.
language	string	Review language given by the source.

Example critic review

This complete row is from a successful run:

{
  "rowType": "review",
  "title": "Breaking Bad: Season 1",
  "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01",
  "mediaType": "season",
  "reviewType": "critic",
  "reviewId": "TV130100",
  "reviewText": "Cranston tackles the role with a measured intensity, bravely putting Walt's flaws and human frailties out on display for all to see. He manages to make you root for the guy even when you know his actions are seriously misguided.",
  "originalScore": "9/10",
  "sentiment": "POSITIVE",
  "createdAt": "2019-10-18T20:55:08.000Z",
  "updatedAt": "2019-10-18T20:55:08.000Z",
  "reviewer": {
    "name": "Cindy White",
    "imageUrl": "https://resizing.flixster.com/hSvqieABHBYEbW6XLz66wXBHnwI=/128x128/v1.YzsxMDAwMDAzMTY3O2o7MjA3NTQ7MjA0ODszNzQ7Mzc0"
  },
  "publication": {
    "name": "IGN",
    "url": "https://www.ign.com/"
  },
  "reviewUrl": "https://www.ign.com/articles/2009/02/27/breaking-bad-the-complete-first-season-dvd-review",
  "isTopCritic": false,
  "language": "English"
}

Example audience review

This complete row is from a successful run:

{
  "rowType": "review",
  "title": "Top Gun: Maverick",
  "url": "https://www.rottentomatoes.com/m/top_gun_maverick",
  "mediaType": "movie",
  "releaseYear": 2022,
  "reviewType": "audience",
  "reviewId": "5f592b65-0ec3-4dd6-8888-a72d3bcba92e",
  "reviewText": "Just a perfect American movie. So watchable and re-watchable.",
  "rating": 5,
  "createdAt": "2025-09-22T02:43:52.597Z",
  "updatedAt": "2025-09-25T17:16:17.205Z",
  "reviewer": {
    "name": "Michael"
  },
  "isVerified": true,
  "isSuperReviewer": false,
  "hasSpoilers": false,
  "hasProfanity": false
}

💳 Pricing

This Actor uses pay-per-event pricing. A paid event applies when a title or public review is successfully saved to your dataset. Check the Apify pricing tab for current prices for your plan.

Event	Charged outcome
Title	One movie, TV series, or season saved to your dataset.
Review	One public critic or audience review saved to your dataset.

🔌 Integrations

Open your dataset through the results link in the run output. Export rows from Apify or read the dataset through the Apify API for your own catalog or research workflow.

Apify tutorial

❓ FAQ

Does a review URL decide which review source is collected?

The reviewType choice sets whose reviews to collect, even when a submitted URL has review query parameters or a fragment. Choose critic, audience, or both in the form.

How do I get season scores instead of series scores?

Choose Titles and submit the season URL, such as https://www.rottentomatoes.com/tv/breaking_bad/s01. A series page and a season page carry their own scores. A series row can also list season names and links.

Can I combine Top Critics and verified audience reviews?

Yes. Choose both for reviewType. Turn on topCriticsOnly to limit critic reviews and verifiedAudienceOnly to limit audience reviews. Each filter applies to its own review source.

What happens when two keywords find the same title?

Only the first eligible occurrence is saved. Later matches are ignored and do not change the saved row. The same rule applies when a title is also submitted by URL.

What happens if I leave Maximum results empty?

The Actor returns all available results until the source is exhausted. Set a positive maxItems value to stop after that many title or review rows across the run.

Will every title have every field?

No. Scores, credits, dates, and other optional fields depend on what Rotten Tomatoes publishes. This Actor does not provide episode lookup, showtimes, streaming prices, or exhaustive cast credits.

Is this the official Rotten Tomatoes website?

No. This is an Apify Actor for collecting public Rotten Tomatoes data. The source website is https://www.rottentomatoes.com/. You do not need a Rotten Tomatoes login for the supported public title data.

📝 Changelog

v0.0 (06-10-2026)

• Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Letterboxd Film & Reviews Scraper: Compare film details, ratings, and reviews from Letterboxd.
• IMDB Reviews Scraper: Add IMDb title details and audience reviews to your film research.
• Douban Movie Scraper: Reviews: Collect Douban movie and TV ratings and public reviews for comparison.
• Text Sentiment Analysis: Classify collected review text as positive, negative, or neutral in a separate run.
• JSON to CSV Converter: Flatten nested title or review data into selected CSV columns.

Made with ❤️ by Maxime Dupré