OrbTop

Rotten Tomatoes Tomatometer & Popcornmeter Score Scraper

AIDEVELOPER TOOLS
Try on Apify

Rotten Tomatoes Tomatometer & Popcornmeter Score Scraper

Scrape Tomatometer and Popcornmeter scores, critics consensus, genres, release dates, runtime, directors, and streaming availability for movies and TV series from Rotten Tomatoes.

What It Does

The scraper discovers titles via the RT sitemap (tens of thousands of movies and TV series) and extracts structured score data from each detail page. For targeted runs, pass a list of specific RT URLs directly and skip the sitemap entirely.

Data comes from three embedded JSON blobs per page — the media scorecard, the JSON-LD schema block, and the where-to-watch affiliate list — so it's stable and doesn't depend on CSS selectors that change with redesigns.

Output

Each record contains:

Field Type Description
title string Movie or TV series title
media_type string movie or tv
rt_url string Canonical RT detail page URL
tomatometer_score integer Critics score (0–100), or null if unscored
tomatometer_state string certified-fresh, fresh, or rotten
critics_review_count integer Number of critics reviews counted
audience_score integer Audience (Popcornmeter) score (0–100)
audience_rating_count integer Number of audience ratings counted
critics_consensus string RT critics consensus text
mpaa_rating string MPAA/content rating (e.g. PG-13, TV-MA)
genres array Genre list from structured data
release_date_theaters string Theatrical release date
release_date_streaming string Streaming release date
runtime_minutes integer Runtime in minutes
directors array Director name(s)
streaming_providers array Current streaming platforms

Input

maxItems (integer, required) — Maximum records to return. Set to 10–100 for test runs, leave higher for bulk pulls.

mediaType (string, optional) — Filter by movie, tv, or leave empty to scrape both. Only applies to sitemap-driven discovery; ignored when startUrls are provided.

startUrls (array, optional) — List of specific RT movie or TV detail page URLs. When provided, the scraper hits those pages directly and skips sitemap discovery entirely. Useful for monitoring a watchlist or validating specific titles.

{
  "maxItems": 100,
  "mediaType": "movie",
  "startUrls": []
}

For targeted runs:

{
  "maxItems": 5,
  "startUrls": [
    { "url": "https://www.rottentomatoes.com/m/dune_part_two" },
    { "url": "https://www.rottentomatoes.com/tv/the_boys_2019" }
  ]
}

Discovery Strategy

Full-catalog runs use RT's public sitemap index at /sitemaps/sitemap.xml, which links to dedicated sitemap files for movies (movie_N.xml) and TV series (tv-series_N.xml). The scraper filters to canonical title pages only — season pages, episode pages, and photo galleries are skipped.

RT detail pages serve structured data via embedded <script> blocks, so no JavaScript rendering is required. The actor runs as a lightweight HTML crawler.

Notes

  • Scores update as new reviews come in — results reflect whatever RT shows at scrape time.
  • Titles with no reviews yet return null for tomatometer_score and audience_score.
  • The tomatometer_state field follows RT's own certification logic: certified-fresh requires a minimum review count plus a score above the threshold; otherwise it's fresh or rotten based on the score.
  • streaming_providers lists the platforms RT shows in the "Where to Watch" module. This is affiliate data and may not reflect every available platform.
Try on Apify