ParseForge Scrapers

Rotten Tomatoes Scraper

parseforge/rottentomatoes-scraper

VideosMARKETINGOther

Scrapes Rotten Tomatoes movie and TV show listings by browse type and sort order. Returns each title with its Tomatometer score, audience score, release date, and synopsis.

Run this scraper See the API call
Total users
2
Monthly active
1
Total runs
100
Bookmarked
0
Rating
Not rated yet
Last modified
12 days ago

Overview

ParseForge

Rotten Tomatoes Scraper

Scrape Rotten Tomatoes movie and TV show listings, sorted by popularity, newest, or top rated, up to a million titles per run. Each title comes with its Tomatometer score, audience score, release date, and synopsis. No API key required. Export to CSV, JSON, Excel, or XML.

Rotten Tomatoes aggregates reviews from critics and audiences into a single score, but browsing thousands of titles manually is slow. This actor reads the public movie and TV show listings directly, filtered by category and sort order, and returns each match in one consistent schema.

Who uses it What they scrape Rotten Tomatoes for
Film distributors Monitor which new releases are trending with audiences and critics.
Content curators Build a searchable database of top-rated films for a recommendation engine.
Market researchers Track genre popularity shifts by analyzing the top-rated titles over time.
Entertainment journalists Identify the most popular new movies to prioritize for review coverage.

What it does

This Actor collects Rotten Tomatoes movie or TV show listings by browse type and sort order, and returns each title as a flat row.

  • ๐ŸŽฌ Movies or TV shows: switch between browsing the movie catalog or the TV series catalog.
  • ๐Ÿ“Š Flexible sorting: collect titles by popularity, newest additions, or top-rated scores.
  • ๐Ÿ“ˆ Scalable volume: set a maximum from 1 to 1,000,000 titles to control the run size.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Rotten Tomatoes data

๐ŸŽฏ Build a watchlist of top-rated new releases.

A streaming service analyst runs the actor weekly with the 'newest' and 'top_rated' sort to identify acquisition targets that are both fresh and critically acclaimed.

๐Ÿ“Š Track critic vs. audience sentiment gaps.

A data journalist collects the most popular movies and compares the Tomatometer and audience scores to find titles with the biggest rating divides for a story.

๐Ÿ” Monitor competitor catalogs.

A studio executive scrapes the top-rated TV shows list monthly to see which series from rival networks are dominating the conversation.

๐Ÿ“‹ Populate a movie database with fresh metadata.

A developer runs the actor to seed a personal project with synopses, scores, and release dates for thousands of films without manual entry.

Why choose this scraper

What you get
Tomatometer score The official critic approval rating for each title.
Audience score The percentage of users who rated the title positively.
Release date The theatrical or streaming premiere date.
Synopsis A brief plot summary for quick content scanning.

How it compares

No other Store actor targets Rotten Tomatoes the same way, so the honest comparison is with the alternatives teams actually weigh.

Rotten Tomatoes Scraper Build it in-house By hand
Setup Run it now, zero config Days of engineering None, but hours per pull
When Rotten Tomatoes changes Maintained for you You fix it You re-learn the page
Proxies, retries, anti-bot Built in Your problem Browser only
Output Fixed JSON schema, CSV/Excel export Whatever you build Copy-paste
Cost Pay per result Engineering time Analyst hours

Configure the run

Drive the Actor by selecting a browse type and a sort order, and the maximum items limit controls how many titles reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
 "browseType": "movies",
 "sortBy": "popular",
 "maxItems": 10
}

A larger pull:

{
 "browseType": "movies",
 "sortBy": "popular",
 "maxItems": 200
}

Pricing

Pay-per-result: $0.021 per result collected. You pay only for the results written to your dataset.

Results collected Approximate cost
100 results $2.10
1,000 results $21.00
10,000 results $210.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

  1. Create a free Apify account with $5 in credit.
  2. Open the Rotten Tomatoes Scraper.
  3. Set your inputs and any filters, then click Start.
  4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Rotten Tomatoes through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/rottentomatoes-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting fewer results than my max items setting?

The actor stops when it has exhausted the available listings for your chosen browse type and sort order. Try a different sort order or switch between movies and TV shows to access more titles.

The run failed with a timeout error. What should I do?

A very high max items value can cause long runtimes. Try reducing the maximum titles or increasing the run timeout in the actor's advanced settings.

Some titles are missing their Tomatometer score.

Titles without enough critic reviews may not have a Tomatometer score yet. This is normal for very new or obscure releases and is not a scraping error.

I selected TV shows but got movie results.

Double-check that the browse type is set to 'TV Shows' and not 'Movies'. The default setting is movies, so you must change it manually before starting the run.

FAQ

Question Answer
Can I scrape both movies and TV shows in one run? No, each run targets either movies or TV shows based on the browse type you select. Run the actor twice with different settings to collect both.
What does the Tomatometer score represent? The Tomatometer score is the percentage of professional critic reviews that are positive for a given title. It is the primary critic rating on Rotten Tomatoes.
Is an API key or login required to use this actor? No. This actor reads the public listing pages directly, so you do not need a Rotten Tomatoes account or API key.
How many titles can I scrape in a single run? You can set the maximum up to 1,000,000 titles. The actual number collected depends on how many titles are available for your chosen browse type and sort order.
Can I filter by genre or release year? The current input schema supports filtering by browse type and sort order only. Genre and year filtering are not available in this version.
What format is the data exported in? You can export your dataset in CSV, JSON, Excel, or XML formats directly from the Apify platform.
Does this actor scrape audience reviews or scores? This actor collects the audience score percentage and the synopsis. It does not scrape the full text of individual user reviews.
How often is the data updated? The actor fetches live data from Rotten Tomatoes each time it runs. Schedule recurring runs in Apify to keep your dataset current.

Related actors

Browse the full ParseForge collection for more scrapers.

๐Ÿ†˜ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

โš ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Fandango Media, LLC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

Input

FieldTypeWhat it doesDefault
browseType string (2 options) Choose whether to scrape movies or TV shows. movies
sortBy string (3 options) Choose how to sort the results. popular
maxItems integer How many movie or TV titles to collect per run. 10

Pricing

from $19.00 per 1,000 results

Charged forWhat it isPrice each
result Single result in the default dataset. $0.019 to $0.021

Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.

API

One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~rottentomatoes-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "browseType": "movies",
    "sortBy": "popular",
    "maxItems": 3
  }'

Examples

Input that runs as-is.

input.json
{
  "browseType": "movies",
  "sortBy": "popular",
  "maxItems": 3
}

Reviews

No reviews yet. Be the first.

Issues

We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.

Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.

Related scrapers

Run Rotten Tomatoes Scraper on Apify All scrapers