editorial.rottentomatoes.com APIeditorial.rottentomatoes.com ↗
Access Rotten Tomatoes movie metadata, critic reviews, Tomatometer scores, TV show details, celebrity filmographies, and editorial news via 7 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/0ca817bf-4b53-4671-acfc-052c237cd967/search?query=dune' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for movies, TV shows, people, and news articles on Rotten Tomatoes. Returns the homepage search results including titles, URLs, images, and Tomatometer scores where available.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'dune') |
{
"type": "object",
"fields": {
"results": "array of objects with title, url, image, score (percentage string or null)"
},
"sample": {
"data": {
"results": [
{
"url": "/m/the_devil_wears_prada_2",
"image": "https://resizing.flixster.com/LmGMosCytLL1JFt1acKxG2CioN0=/206x305/v2/...",
"score": "78%",
"title": "The Devil Wears Prada 2"
},
{
"url": "/m/hokum",
"image": "https://resizing.flixster.com/...",
"score": "88%",
"title": "Hokum"
}
]
},
"status": "success"
}
}About the editorial.rottentomatoes.com API
This API exposes 7 endpoints covering Rotten Tomatoes movie and TV data, including critic reviews with pagination, Tomatometer scores, cast and director metadata, and editorial news articles. The get_movie_details endpoint returns a structured metadata object with genre, aggregate rating, content rating, and an emsId field you can pass directly to get_reviews to retrieve paginated critic quotes, original scores, and publication names.
Movie and TV Show Data
The get_movie_details and get_tv_show_details endpoints accept a URL slug (e.g., dune_part_two or breaking_bad) and return a metadata object drawn from JSON-LD structured data. For movies this includes name, genre, actor, director, aggregateRating, contentRating, and dateCreated. TV responses add numberOfSeasons and a containsSeason array. Both endpoints also return an emsId string that serves as the key for fetching reviews.
Critic Reviews
get_reviews accepts an ems_id from either detail endpoint and returns paginated arrays of review objects. Each review includes reviewId, scoreSentiment, originalScore, reviewQuote, critic, and publication. Pagination is cursor-based: pass the endCursor value from pageInfo as the after parameter in the next call. The pageInfo object also exposes hasNextPage and hasPreviousPage booleans so you can walk the full review set without guessing offsets.
Search, Browse, and People
The search endpoint accepts a free-text query and returns an array of results across movies, TV shows, people, and news — each with title, url, image, and score (a percentage string or null when no Tomatometer exists). browse_movies accepts a status parameter (movies_in_theaters, movies_at_home, or upcoming_movies_in_theaters) to pull current trending tiles from the homepage. get_person_details accepts a person slug and returns structured metadata including birthDate, birthPlace, and an itemListElement filmography list, plus a separate filmography array parsed from an HTML table when present.
Editorial News
get_news_articles fetches articles from the Rotten Tomatoes editorial site. Each article in the response is a WordPress post object with id, date, slug, link, title.rendered, excerpt.rendered, author, and jetpack_featured_media_url. Results are ordered by most recent and support page and per_page pagination parameters.
- Aggregate critic review quotes and original scores for a film using
get_reviewswith cursor pagination. - Display current Tomatometer scores for movies in theaters by calling
browse_movieswithstatus: movies_in_theaters. - Build a person profile page with birthdate, biography, and full filmography via
get_person_details. - Power an entertainment search bar that returns scored results across movies, shows, and people using the
searchendpoint. - Track editorial coverage of a title by querying
get_news_articlesand filtering by slug or keyword. - Compare critic sentiment and
scoreSentimentvalues across a TV show's full review history usingget_reviewswith itsemsId. - Populate a movie detail view with cast, director, genre, and content rating from the
metadataobject returned byget_movie_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Rotten Tomatoes have an official public developer API?+
How do I get paginated critic reviews for a movie or show?+
get_movie_details or get_tv_show_details with the relevant slug to retrieve the emsId field. Pass that value to get_reviews along with an optional page_count. Each response includes a pageInfo object with hasNextPage and endCursor. Pass endCursor as the after parameter in the next call to advance through the full review set.Does the API return audience scores in addition to Tomatometer scores?+
search and browse_movies endpoints return a single score field which reflects the Tomatometer percentage. The metadata object from detail endpoints includes aggregateRating from JSON-LD structured data. Separate audience score fields are not currently exposed. You can fork this API on Parse and revise it to add an endpoint targeting the audience score data.Is season- or episode-level data available for TV shows?+
get_tv_show_details endpoint returns numberOfSeasons and a containsSeason array at the show level. Individual episode metadata, per-episode ratings, and episode-level reviews are not currently returned. You can fork this API on Parse and revise it to add episode-level endpoints.What is the `filmography` array in `get_person_details` and when is it empty?+
filmography field is parsed from an HTML credits table on the person's page. It contains objects with rating, title, url, role, and year. When that table is absent from the page — which can happen for some personalities or crew members — the array is returned empty. The itemListElement inside metadata is the fallback source for filmography credits in those cases.