Tomatometer and audience score collection
Use Rotten Tomatoes endpoints to turn tomatometer and audience score collection into repeatable API requests with documented inputs and JSON responses.
Join Rotten Tomatoes title records and score cohorts to the editorial layer: enumerate browse filters, search guides and articles, resolve critic directory pages, and page through eligible sitemap URLs alongside movie, TV, and person detail.
Extract Rotten Tomatoes title scores, reviews, critic directories, editorial collections, browse filters, and robots-eligible sitemap URLs as structured JSON.
Endpoint families
6
Documented params
92
Examples
20
Live catalog snapshot
Active endpoints
20
Methods
GET
Required params
27
Schema refs
20
{
"platform": "Rotten Tomatoes",
"endpoint": "rottentomatoes-search",
"method": "GET",
"path": "/rottentomatoes/search",
"auth": "apiKey"
}Related use cases
Use cases
Extract Rotten Tomatoes title scores, reviews, critic directories, editorial collections, browse filters, and robots-eligible sitemap URLs as structured JSON.
Use Rotten Tomatoes endpoints to turn tomatometer and audience score collection into repeatable API requests with documented inputs and JSON responses.
Use Rotten Tomatoes endpoints to turn critic and audience review monitoring into repeatable API requests with documented inputs and JSON responses.
Use Rotten Tomatoes endpoints to turn movie and tv catalog enrichment into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Rotten Tomatoes endpoint catalog — 20 endpoints, 92 documented request parameters, and 20 published response schemas — the same catalog Docs and Playground run against.
20 documented Rotten Tomatoes endpoints, grouped into 11 request families — Editorial, Browse and Movie, plus 8 more.
92 request parameters are documented across those Rotten Tomatoes endpoints, 27 of them required — the full input contract is public before you write any integration code.
20 of the 20 Rotten Tomatoes endpoints ship a recorded example response, and 20 carry a documented response schema — you can code against the real JSON before the first request.
Rotten Tomatoes endpoints document their error responses (400, 404, 429, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
20 hosted MCP tools back the Rotten Tomatoes endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/rottentomatoes/editorial/content
/rottentomatoes/browse/movies
/rottentomatoes/movie
/rottentomatoes/critics/authors
/rottentomatoes/episode
/rottentomatoes/person
Featured endpoints
/rottentomatoes/searchSearches Rotten Tomatoes movies by the required `query`, returning up to `limit` rows (default 10, max 20). Each row has the title, URL, release year or start and end year, `tomatometer_score` and sentiment, `certified_fresh`, cast and image. No matches returns an empty `results` array.
Response notes
- Returns movie rows from Rotten Tomatoes search. - A true no-results page returns an empty `results` array. Challenge pages or parser drift return an upstream error.
Sampled 14 Oct 2026: 10 items, 7 fields filled in every item, 2 not. tomatometer_sentiment: NEGATIVE (4), POSITIVE (2); release_year: 1,999 to 2,019, median 2,010.
MCP tool rottentomatoes_search
/rottentomatoes/movieReturns Rotten Tomatoes movie metadata, scorecard data, and representative audience reviews. Pass exactly one of `path` or `url`.
Response notes
- `data.public_page_derived` is `true`. - `critics_score` and `audience_score` are included only when the public page exposes scorecard data. - Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.
Sampled 14 Oct 2026: 6 items, 8 fields filled in every item. display_date: “Mar 19, 2026” and 3 other values; verified: true in 6 of 6.
MCP tool rottentomatoes_movie
/rottentomatoes/seriesReturns Rotten Tomatoes TV series metadata and scorecard data. Pass exactly one of `path` or `url`.
Response notes
- `data.public_page_derived` is `true`. - `critics_score` and `audience_score` are included only when the public page exposes scorecard data. - `seasons` comes from public `TVSeries` JSON-LD `containsSeason` entries. - Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.
Sampled 14 Oct 2026: 5 items, 3 fields filled in every item. name: “Bryan Cranston” and 4 other values; url: rottentomatoes.com.
MCP tool rottentomatoes_series
/rottentomatoes/seasonReturns Rotten Tomatoes TV season metadata, scorecard data, parent series metadata, and episode rows. Pass exactly one of `path` or `url`.
Response notes
- `data.public_page_derived` is `true`. - `episodes` comes from public `TVSeason` JSON-LD `episode` entries. - `critics_score` and `audience_score` are included only when the public page exposes scorecard data. - Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.
Sampled 14 Oct 2026: 7 items, 6 fields filled in every item. air_date: 2008-01-20 to 2008-03-09; episode_number: 1 to 7, median 4.
MCP tool rottentomatoes_season
/rottentomatoes/episodeReturns Rotten Tomatoes TV episode metadata, scorecard data, parent series/season metadata, and public video metadata. Pass exactly one of `path` or `url`.
Response notes
- `data.public_page_derived` is `true`. - `parent_series` and `parent_season` come from public JSON-LD and vanity metadata when exposed by the page. - `video` is included only when the public `TVEpisode` JSON-LD exposes video metadata. - `critics_score` and `audience_score` are included only when the public page exposes scorecard data. Some episode pages expose review/rating counts without score percentages. - Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.
Sampled 14 Oct 2026: 6 items, 3 fields filled in every item. name: “Bryan Cranston” and 5 other values; url: rottentomatoes.com.
MCP tool rottentomatoes_episode
/rottentomatoes/movie/reviewsReturns critic or audience reviews from Rotten Tomatoes, including pagination metadata. Pass exactly one of `path` or `url`. Supported `type` values are `critics`, `top-critics`, `audience`, and `verified-audience`.
Response notes
- `data.public_page_derived` is `true`. - `data.page_info.has_next_page` and `data.page_info.end_cursor` expose Rotten Tomatoes pagination state when another page is available. - Review type values other than `critics`, `top-critics`, `audience`, and `verified-audience` are rejected before upstream IO. - Blocked pages, malformed review JSON, and parser drift return upstream errors.
Sampled 14 Oct 2026: 6 items, 17 fields filled in every item, 1 not. critic_url: rottentomatoes.com; top_review: true in 0 of 6.
MCP tool rottentomatoes_movie_reviews
Related APIs
Media & Streaming
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
How to scrape Rotten Tomatoes
Rotten Tomatoes ended its open developer API and licenses data through Fandango. This 16-endpoint surface reads public title and editorial pages: title details and review cohorts sit beside browse filters, critic directories, WordPress editorial collections, and the public sitemap index. The sitemap URL endpoint excludes paths disallowed by Rotten Tomatoes' robots rules.
The search endpoint takes a query and returns movie rows from Rotten Tomatoes' server-rendered search, each carrying the path you need next.
Movie, series, season, and episode endpoints each take a path or a full url — whichever you already have.
The reviews endpoint takes a type of critics, top-critics, audience, or verified-audience, with limit and an after cursor for paging.
Movie browse covers movies_in_theaters, movies_at_home, and movies_coming_soon sorted by popular, newest, or top_box_office; TV browse covers the series listing.
Call /rottentomatoes/browse/filters with one of the four lists to read its current sort, genre, rating, audience, critic, and selected affiliate values before sending browse requests; filter values are scoped to that list.
Use /rottentomatoes/editorial/types to discover the accepted collection types, then page /rottentomatoes/editorial/content. Editorial search is separate and can return third-party source URLs without fetching those sites.
Page the critic directory by letter or name search, with inactive critics as an optional cohort. For coverage discovery, list current child sitemaps, then page one named sitemap; URL results omit paths excluded by robots rules.
FAQ
Not an open one. Rotten Tomatoes discontinued public developer access and now licenses data through Fandango partnerships. Crawlora is not affiliated with Rotten Tomatoes; its endpoints read the credential-free public pages and return the scores and reviews as JSON.
Yes. Title detail returns the critic Tomatometer and the audience score together, along with cast and crew, for movies, series, seasons, and episodes.
The reviews endpoint's type parameter takes critics, top-critics, audience, or verified-audience, so each cohort is its own call rather than something you filter client-side.
A Rotten Tomatoes path or the full url. Search returns the path, so the normal flow is search first, then pass the path to the detail or reviews endpoint.
Read /rottentomatoes/browse/filters for the selected list first. The accepted values vary by list and change over time, so the response is the current source for sort, genre, rating, audience, critic, and affiliate filters.
The sitemap index lists public child inventories. The URL endpoint returns eligible paths from one child sitemap and excludes gallery, search, account, and other URLs disallowed by Rotten Tomatoes' robots rules.
Call /rottentomatoes/editorial/types, then pass one returned value to /rottentomatoes/editorial/content. The live-checked set includes article, guide, gallery, hub-subpage, rt-hub, how-to, and several other public collection types.