Rotten Tomatoes Scraper

A powerful Apify Actor for scraping movie ratings, TV show information, streaming content, posters, and spoilers from Rotten Tomatoes and related sources.

Features

• Movie Information: Get Tomatometer scores, audience scores, critics consensus, and reviews
• TV Show Information: Get ratings, cast, seasons, and photos for TV shows
• Streaming Content: Browse movies and TV shows available on major streaming platforms
• Coming Soon: Get upcoming movies in theaters
• Netflix Top 100: Get the top 100 TV shows on Netflix
• Today's Recommendations: Get daily recommendations from Rotten Tomatoes
• Critics Database: Query critics by name
• Search: Search for movies, TV shows, and actors
• Movie Posters: Search and browse movie posters from CineMaterial
• Spoilers: Get movie spoilers from MoviePooper

Input Parameters

Parameter	Type	Required	Description
action	string	Yes	The scraping action to perform (see Actions below)
name	string	No	Movie or TV show name (for get_movie, get_tv_show)
page	integer	No	Page number for paginated results (default: 1)
sortby	string	No	Sort order for streaming content
genre	string	No	Genre filter for streaming movies
letter	string	No	Single letter (a-z) for critics query
endCursor	string	No	Pagination cursor for critics
search_term	string	No	Search term for Algolia search
query	string	No	Query for poster/spoiler search
full_id	string	No	Full ID for poster details
versions_gallery_id	string	No	Gallery ID for poster versions
spoiler_id	string	No	Movie ID for spoilers
after	string	No	Cursor for streaming content pagination

Available Actions

Action	Description	Required Parameters
get_movie	Get movie information	name
get_tv_show	Get TV show information	name
soon_in_theaters	Get upcoming movies	page (optional)
top100_netflix	Get top 100 Netflix shows	None
streaming_movies	Browse streaming movies	genre, sortby, after (all optional)
streaming_tv	Browse streaming TV shows	sortby, after (optional)
today_recommendations	Get daily recommendations	None
query_critics	Query critics by letter	letter, endCursor (optional)
search	Search content	search_term
query_posters	Search movie posters	query
get_poster_details	Get poster details	full_id
get_poster_gallery	Get poster gallery	versions_gallery_id
vintage_us_posters	Browse vintage US posters	page (optional)
classic_polish_posters	Browse classic Polish posters	page (optional)
search_spoilers	Search movies for spoilers	query
get_spoilers	Get movie spoilers	spoiler_id

Example Input

Get Movie Information

{
    "action": "get_movie",
    "name": "The Matrix"
}

Get Streaming Movies by Genre

{
    "action": "streaming_movies",
    "genre": "sci-fi",
    "sortby": "critic_highest"
}

Search for Content

{
    "action": "search",
    "search_term": "Christopher Nolan"
}

Output Format

All results are returned in a consistent format:

{
    "action": "get_movie",
    "success": true,
    "data": {
        "title": "The Matrix",
        "tomatometer_score": 83,
        "audience_score": 85,
        "critics_consensus": "...",
        "image": "https://..."
    },
    "error": null,
    "timestamp": "2026-03-18T12:00:00Z"
}

Environment Variables

Variable	Description
GOOGLE_TRANSLATE_API_KEY	Google Translate API key for non-English movie name translation (optional)

Set this in Apify Console under Actor Settings → Environment Variables.

Sort Options

For streaming_movies and streaming_tv actions:

• most_popular - Sort by popularity
• newest - Sort by release date
• a_z - Sort alphabetically
• critic_highest - Highest critic scores first
• critic_lowest - Lowest critic scores first
• audience_highest - Highest audience scores first
• audience_lowest - Lowest audience scores first

Genre Options

For streaming_movies action:

action, adventure, animation, anime, biography, comedy, crime, documentary, drama, entertainment, faith-spirituality, fantasy, game-show, health-wellness, history, holiday, horror, house-garden, kids-family, music, musical, mystery-thriller, nature, news, reality, romance, sci-fi, short, soap, special-interest, sports, stand-up, talk-show, travel, variety, war, western, lgbtq, other

License

This Actor is provided for educational and personal use. Please respect the terms of service of the websites being scraped.