Rotten Tomatoes Scraper - Movie & TV Ratings

Scrape movie and TV show ratings from Rotten Tomatoes -- the most trusted review-aggregation service for film and television.

What it does

• Search mode: Search for movies and TV shows by keyword and extract full rating data
• Details mode: Provide direct Rotten Tomatoes URLs to scrape specific titles

Extracts data from JSON-LD structured data and inline score JSON embedded in each page -- no JavaScript rendering needed.

Input Parameters

Parameter	Type	Description
mode	string	search (keyword search) or details (direct URLs). Default: search
searchQueries	string[]	Search keywords (e.g. "inception", "breaking bad"). Used in search mode
startUrls	array	List of rottentomatoes.com URLs. Used in details mode
limit	integer	Max number of results. Default: 10, max: 1000
proxyConfiguration	object	Proxy settings (residential recommended)

Output Fields

Each result contains:

Field	Type	Description
title	string	Movie or TV show title
year	integer	Release year
tomatoMeter	integer	Tomatometer (critics) score as percentage
audienceScore	integer	Audience score as percentage
synopsis	string	Plot summary / description
genre	string[]	Genre list (e.g. ["Sci-Fi", "Action"])
rating	string	Content rating (PG-13, R, TV-MA, etc.)
runtime	string	Runtime (e.g. "2h 28m")
director	string	Director name(s)
cast	string[]	Cast member names
criticsConsensus	string	Critics consensus summary
imageUrl	string	Poster image URL
url	string	Source Rotten Tomatoes URL
type	string	"movie" or "tv"
scrapedAt	string	ISO 8601 timestamp

Example Output

{
  "title": "Inception",
  "year": 2010,
  "tomatoMeter": 87,
  "audienceScore": 91,
  "synopsis": "Dom Cobb is a thief with the rare ability to enter people's dreams...",
  "genre": ["Sci-Fi", "Mystery & Thriller", "Action"],
  "rating": "PG-13",
  "runtime": "2h 28m",
  "director": "Christopher Nolan",
  "cast": ["Leonardo DiCaprio", "Joseph Gordon-Levitt", "Elliot Page", "Tom Hardy"],
  "criticsConsensus": "Smart, innovative, and thrilling, Inception is that rare summer blockbuster...",
  "imageUrl": "https://resizing.flixster.com/...",
  "url": "https://www.rottentomatoes.com/m/inception",
  "type": "movie",
  "scrapedAt": "2026-04-26T10:00:00.000Z"
}

Example Inputs

Search for movies by keyword

{
  "mode": "search",
  "searchQueries": ["inception", "the dark knight"],
  "limit": 20
}

Scrape specific movie URLs

{
  "mode": "details",
  "startUrls": [
    { "url": "https://www.rottentomatoes.com/m/inception" },
    { "url": "https://www.rottentomatoes.com/tv/breaking_bad" }
  ]
}

How it works

1. Search mode: Fetches the RT search page which contains SSR <search-page-media-row> web components with score attributes and title links. Extracts URLs, then fetches each detail page.
2. Details mode: Directly fetches provided URLs.
3. Data extraction: Each detail page has JSON-LD Movie/TVSeries schema plus inline JSON blobs containing audience scores, critics scores, synopsis, and consensus.

Notes

• Tomatometer represents the percentage of professional critic reviews that are positive.
• Audience Score represents the percentage of audience members who rated the film/show positively.
• Search results include both movies and TV shows.
• Residential proxies recommended to avoid rate limiting.