新鲜度指数与观众评分采集
Use Rotten Tomatoes endpoints to turn 新鲜度指数与观众评分采集 into repeatable API requests with documented inputs and JSON responses.
以规范化 JSON 采集 Rotten Tomatoes 的电影、剧集、季和单集详情，包括新鲜度指数（Tomatometer）和观众评分、影评人及观众评论、演职人员，以及浏览列表，用于目录和研究。
从公开页面提取 Rotten Tomatoes 的电影和剧集评分、评价、评论、季、集及人物数据，转换为结构化 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
从公开页面提取 Rotten Tomatoes 的电影和剧集评分、评价、评论、季、集及人物数据，转换为结构化 JSON。
Use Rotten Tomatoes endpoints to turn 新鲜度指数与观众评分采集 into repeatable API requests with documented inputs and JSON responses.
Use Rotten Tomatoes endpoints to turn 影评人及观众评论监控 into repeatable API requests with documented inputs and JSON responses.
Use Rotten Tomatoes endpoints to turn 电影和剧集目录数据增强 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.
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.
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.
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.
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.
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.
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 已停止开放的开发者访问，现在通过 Fandango 对数据进行授权。Crawlora 的 9 个 Rotten Tomatoes 端点转而读取无需凭证的公开页面，将电影、剧集、季和单集详情——包括新鲜度指数和观众评分、影评人及观众评论、演职人员和浏览列表——返回为规范化 JSON。
搜索端点接受一个查询词，并从 Rotten Tomatoes 服务端渲染的搜索结果中返回电影条目，每条都带有下一步所需的 path。
电影、剧集、季和单集端点各自接受 path 或完整的 url——取决于你已有哪一种。
评论端点接受 type 参数，可选 critics、top-critics、audience 或 verified-audience，并支持 limit 和 after 游标用于分页。
电影浏览覆盖 movies_in_theaters、movies_at_home 和 movies_coming_soon，可按 popular、newest 或 top_box_office 排序；剧集浏览覆盖剧集列表。
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
没有开放的官方 API。Rotten Tomatoes 已停止公开的开发者访问，现在通过 Fandango 合作关系对数据进行授权。Crawlora 与 Rotten Tomatoes 没有关联；其端点读取的是无需凭证的公开页面，并将评分和评论返回为 JSON。
可以。片名详情会一并返回影评人的新鲜度指数和观众评分，以及电影、剧集、季和单集的演职人员信息。
评论端点的 type 参数接受 critics、top-critics、audience 或 verified-audience，因此每个群体都是独立的调用，而不是在客户端进行筛选。
Rotten Tomatoes 的 path 或完整 url。搜索会返回 path，因此常规流程是先搜索，再将 path 传给详情或评论端点。
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.