Rotten Tomatoes Scraper

Rotten Tomatoes Scraper: Tomatometer, Popcornmeter and credits for any title

Type film and TV titles, or paste Rotten Tomatoes URLs, and get one row per title: the Tomatometer and the Popcornmeter with their review counts, average ratings and fresh-rotten splits, the critics consensus paragraph, genres, age rating, runtime, release dates, US box office, cast and crew, the poster and the site's own ids.

The critic review texts are not in there. You get the scores, the counts and the consensus, plus a link to the reviews pages if you want to read them yourself.

🍅 What Rotten Tomatoes Scraper does

Give it titles and it searches the site the way its own search box does, then reads the page it lands on. Give it URLs and it reads exactly those. You can do both in one run, and a title that turns up in both is read once.

Titles are the safer input, not slugs. Rotten Tomatoes puts a year in the slug when something has been remade, and not where you would guess. /m/cats is not the 2019 musical, which lives at /m/cats_2019. /m/oppenheimer is not the Nolan film, which is /m/oppenheimer_2023. Casablanca sits at /m/1003707-casablanca. Searching oppenheimer lands on the right one.

Search has the opposite trap. breaking bad on the default setting comes back as *El Camino: A Breaking Bad Movie*, because the film outranks the series in the site's own relevance. Set Movies, TV, or both to TV when you mean the show, or paste /tv/breaking_bad.

📥 What you give it

{
  "searchQueries": ["dune part two", "anora", "severance"],
  "mediaType": "any",
  "resultsPerQuery": 1,
  "maxItems": 50
}

Or by URL:

{
  "startUrls": [
    "https://www.rottentomatoes.com/m/anora",
    "https://www.rottentomatoes.com/tv/severance/s02"
  ]
}

📤 What you get back

A real row from a recent run, with the synopsis, the cast list and the poster URL cut short:

{
  "url": "https://www.rottentomatoes.com/m/dune_part_two",
  "slug": "dune_part_two",
  "path": "/m/dune_part_two",
  "mediaType": "Movie",
  "isMovie": true,
  "title": "Dune: Part Two",
  "seriesTitle": null,
  "year": 2024,
  "tomatometer": 92,
  "tomatometerSentiment": "POSITIVE",
  "tomatometerCertifiedFresh": true,
  "criticsAverageRating": 8.4,
  "criticReviewCount": 466,
  "criticsFreshCount": 429,
  "criticsRottenCount": 37,
  "topCriticsScore": 87,
  "topCriticsReviewCount": 78,
  "audienceScore": 95,
  "audienceSentiment": "POSITIVE",
  "audienceAverageRating": 4.7,
  "audienceReviewCount": 2244,
  "audienceRatingCountText": "5,000+ Verified Ratings",
  "audienceLikedCount": 7468,
  "audienceNotLikedCount": 412,
  "criticsConsensus": "Visually thrilling and narratively epic, Dune: Part Two continues Denis Villeneuve's adaptation of the beloved sci-fi series in spectacular form.",
  "synopsis": "\"Dune: Part Two\" will explore the mythic journey of Paul Atreides as he unites with Chani and the Fremen...",
  "genres": ["Sci-Fi", "Adventure", "Action", "Fantasy", "Drama"],
  "contentRating": "PG-13",
  "originalLanguage": "English",
  "runtime": "2h 46m",
  "runtimeMinutes": 166,
  "releaseDateTheaters": "Mar 1, 2024, Wide",
  "rereleaseDateTheaters": null,
  "releaseDateStreaming": "Apr 16, 2024",
  "airDate": null,
  "boxOfficeGrossUsa": "$282.0M",
  "directors": ["Denis Villeneuve"],
  "creators": [],
  "writers": ["Denis Villeneuve", "Jon Spaihts"],
  "producers": ["Mary Parent", "Cale Boyter", "Denis Villeneuve", "..."],
  "distributor": "Warner Bros. Pictures",
  "productionCompanies": ["Legendary Pictures"],
  "network": null,
  "soundMix": ["Dolby Atmos", "Dolby Digital"],
  "aspectRatio": null,
  "castAndCrew": [
    { "name": "Denis Villeneuve", "role": "Director", "url": "https://www.rottentomatoes.com/celebrity/denis-villeneuve" },
    { "name": "Timothée Chalamet", "role": "Paul Atreides", "url": "https://www.rottentomatoes.com/celebrity/timothee_chalamet" }
  ],
  "numberOfSeasons": null,
  "seasons": [],
  "posterUrl": "https://resizing.flixster.com/Wk685cwvPp6E6fAnFc1noRRCtX0=/164x246/v2/...",
  "criticReviewsUrl": "https://www.rottentomatoes.com/m/dune_part_two/reviews",
  "audienceReviewsUrl": "https://www.rottentomatoes.com/m/dune_part_two/reviews/verified-audience",
  "emsId": "cecd223d-a20d-3268-bbef-9a4c847c673d",
  "rtId": "771566273",
  "searchQuery": "dune part two",
  "position": 1,
  "scrapedAt": "2026-09-20T02:35:10.721Z"
}

TV series pages carry an averaged score and no consensus. That is how the site presents them. Ask for one season, /tv/severance/s02, and you get a real Tomatometer, a real review count and that season's consensus.

🧾 Reading the output

Run it with no titles and no URLs and you get the one sample row. Every diagnostic row carries a hint alongside its code.

One bad title never stops the rest, and a diagnostic row never fails the run.

▶️ How to run it

1. Open Rotten Tomatoes Scraper and click Try for free. 2. Put titles into Titles to look up, one per line, or paste addresses into Rotten Tomatoes URLs. 3. Set Movies, TV, or both if a title is ambiguous. 4. Set Maximum titles, then click Start. 5. Download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$4.60 per 1,000 titles. Flat on every Apify plan, no volume tiers.

You pay per title row delivered. Diagnostic rows, a title the site has no match for, a page with no scores yet, a duplicate across your two input fields, and the sample row are all free.

💡 What people use it for

• Running a watchlist weekly and diffing on tomatometer and criticReviewCount to watch a score

settle after release.

• Pulling scores for a catalogue of titles to sit beside your own data.
• Comparing the critic score against the audience score across a genre or a studio.
• Checking a season at a time on a returning series, rather than the averaged series score.
• Grabbing consensus paragraphs and posters to build a listing page.

🚧 What it does not do

• No individual critic reviews. Scores, counts, the split and the consensus, yes. The quotes

from each named critic, no. criticReviewsUrl and audienceReviewsUrl point at those pages.

• castAndCrew is the top of the credits. A 60-name ensemble is not in there.
• TV series pages have an averaged score and no consensus. Ask for a season instead.
• Some titles simply have no scores, and come back as an uncharged NOT_SCORED_YET row rather

than a row full of nulls.

• Dates and box office arrive as the site writes them, not as ISO dates or numbers. Box office

is US gross, and missing on most TV and on anything without a wide US release.

• Search is a search, not an exact-match lookup. One line in, the best match out. Use the URL

when you need a guarantee.

• No episodes, showtimes or streaming prices. seasons gives you links to go deeper, and

nothing follows them for you.

🧭 Which ratings scraper do you need?

❓ Questions people ask

Is there a public Rotten Tomatoes API? Not a self-serve one. This reads the public site and needs nothing from you but the titles.

Do I need a login? No. No account, no cookie, no key.

How do I look up one season rather than the whole show? Paste the season address, like https://www.rottentomatoes.com/tv/the_last_of_us/s01. Searching the show name gives you the series page and its averaged score.

What happens when a title does not exist? You get an uncharged diagnostic row with NO_MATCH or NOT_FOUND and a hint about the usual cause. The run still finishes.

Can I run it on a schedule? Yes. Scores and review counts move, so a weekly pass over a watchlist is the common use. scrapedAt is on every row for diffing.

Is scraping Rotten Tomatoes legal? These are public title pages. The site's terms govern what you may do with the content, so read them against your plan. Apify's write-up on scraping and the law is a starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the run ID and the titles or URLs you used. The errorCode on the diagnostic row usually names the problem on its own.