トマトメーター指数と観客評価の収集
Rotten Tomatoesエンドポイントを使えば、「トマトメーター指数と観客評価の収集」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
正規化JSONを使って、Rotten Tomatoesの映画、シリーズ、シーズン、エピソード詳細（トマトメーター指数と観客評価を含む）、批評家・観客レビュー、出演者・スタッフ情報、閲覧リストを収集し、カタログとリサーチに活用できます。
公開ページから、Rotten Tomatoesの映画・シリーズの評価、批評、コメント、シーズン、エピソード、人物データを構造化JSONとして抽出できます。
エンドポイントファミリー
6
ドキュメント化されたパラメータ
108
サンプル数
24
ライブカタログスナップショット
稼働エンドポイント
24
メソッド
GET
必須パラメータ
33
スキーマ参照
24
{
"platform": "Rotten Tomatoes",
"endpoint": "rottentomatoes-search",
"method": "GET",
"path": "/rottentomatoes/search",
"auth": "apiKey"
}関連ユースケース
ユースケース
公開ページから、Rotten Tomatoesの映画・シリーズの評価、批評、コメント、シーズン、エピソード、人物データを構造化JSONとして抽出できます。
Rotten Tomatoesエンドポイントを使えば、「トマトメーター指数と観客評価の収集」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Rotten Tomatoesエンドポイントを使えば、「批評家・観客レビューのモニタリング」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Rotten Tomatoesエンドポイントを使えば、「映画・シリーズカタログのデータ拡充」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のRotten Tomatoesエンドポイントカタログから取得しています（エンドポイント24件、ドキュメント化されたリクエストパラメータ108個、公開レスポンススキーマ24件）。DocsとPlaygroundが参照しているカタログと同じものです。
Rotten Tomatoesのエンドポイントは24件、14つのリクエストファミリーに分類されています（Editorial、Browse、Movieほか11件）。
これらのRotten Tomatoesエンドポイントには108個のリクエストパラメータがドキュメント化されており、うち33個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
24件のRotten Tomatoesエンドポイントのうち24件が実際のサンプルレスポンスを、24件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Rotten Tomatoesのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Rotten Tomatoesのエンドポイントは24個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/rottentomatoes/editorial/content
/rottentomatoes/browse/movies
/rottentomatoes/movie
/rottentomatoes/publication
/rottentomatoes/critic/publications
/rottentomatoes/critics/authors
主要エンドポイント
/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.
レスポンスに関する注記
- 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ツール rottentomatoes_search
/rottentomatoes/moviesReturns the details of up to 20 Rotten Tomatoes movies in one call, in the order requested. Each entry carries the title, synopsis, path and URL, `ems_id`, runtime, release date/year, production companies, the release runs with distributors, the Tomatometer and Popcornmeter scores, the score variants for all critics, top critics, all audience and verified audience, the critics and audience consensus, and `where_to_watch`: the public streaming, rental and purchase offers with provider name, link, licence, quality, price and availability date. Those are public provider pages, not playable media URLs. Identifiers that resolve to nothing are listed in `data.not_found` instead of failing the call. Pass exactly one of `ids` (Rotten Tomatoes `ems_id` values) or `paths` (Rotten Tomatoes movie paths or URLs); the `paths` form resolves each path first, so it costs one extra upstream read per path. The headline Tomatometer and Popcornmeter carry no counts; review and rating counts are in the score variants (for the number of critic reviews read `scores.critics_all.review_count`). Review samples are not returned here: use `/rottentomatoes/movie/reviews` for reviews. `data.fetched_at` is the UTC fetch time.
レスポンスに関する注記
- The titles are read in one upstream request. An id or path that resolves to no movie is left out of `data.movies` and listed in `data.not_found`, in request order; the rest of the batch is still returned. If nothing resolves the call returns `404`. - Each entry has `ems_id`, `path`, `url`, `title`, `description`, `media_type` (always `Movie`), `release_date`, `release_year`, `runtime_minutes`, `rotten_tomatoes_id`, `fandango_id`, `poster_url`, `image_url`, `production_companies` and `releases` (date, type, country and distributors per run). - `critics_score` and `audience_score` are the headline Tomatometer and Popcornmeter as the title page shows them (score, sentiment, certified, average rating). The upstream attaches no counts to them. - `scores` holds the four variants that do carry counts: `critics_all`, `critics_top`, `audience_all` and `audience_verified`. Each has `review_count`, `rating_count`, `liked_count` and `not_liked_count` where the upstream reports them; a reported `0` is returned as `0`, and a count the upstream omits is absent. To follow how many critic reviews a title has, read `scores.critics_all.review_count`. - `critics_consensus` and `audience_consensus` are the consensus sentences when the title has them. `has_critics_all`, `has_critics_top`, `has_audience_all` and `has_audience_verified` say whether those review lists exist. - `lifecycle` is the title's current release stage (for example `IN_THEATERS`) and `call_to_action` the primary button the title page shows. - `where_to_watch[]` lists the public places the title can be watched or bought: `name`, `provider_id`, `title`, `url`, `license`, `quality`, `price`, `availability_date` and `preorder`, each present when the provider reports it. `license` is one of `stream`, `rent`, `purchase`, `buy tickets` or `preorder`. The `url` is the provider's public page, not a playable media URL, and `price` is as the provider lists it, without a currency symbol. - Review samples are not included; use `/api/v1/rottentomatoes/movie/reviews` for a title's reviews.
MCPツール rottentomatoes_movies
/rottentomatoes/movieReturns Rotten Tomatoes movie metadata, scorecard data, and representative audience reviews. Pass exactly one of `path` or `url`.
レスポンスに関する注記
- `data.public_page_derived` is `true`. - `critics_score` and `audience_score` are included only when the public page exposes scorecard data. - `critics_score` (the Tomatometer) carries `score`, `sentiment`, `certified`, `average_rating`, `liked_count` (fresh reviews), `not_liked_count` (rotten reviews) and `review_count`, the number of critic reviews the score is built from. `rating_count` repeats it. The count grows as critics publish, so it is the cheap way to see whether new critic reviews have appeared. `reviews_page_url` is the page that lists them. - `audience_score` (the Popcornmeter) uses the same field names but its counts are not one population: for a new release `review_count` can be far below `liked_count` plus `not_liked_count`, which count ratings. Use `banded_rating_count` (for example `2,500+ Verified Ratings`) as the headline size and `score_type` (`VERIFIED` or `ALL`) to see which audience it covers. - `ems_id` is Rotten Tomatoes' stable id for the title; it stays the same when the page path changes and is the id the critic-review feed is keyed on. - `fetched_at` is the UTC time the page was read. Responses are cached for about ten minutes, so polling more often than that returns the same reading. - Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors.
MCPツール rottentomatoes_movie
/rottentomatoes/seriesReturns Rotten Tomatoes TV series metadata and scorecard data. Pass exactly one of `path` or `url`.
レスポンスに関する注記
- `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ツール rottentomatoes_series
/rottentomatoes/seasonReturns Rotten Tomatoes TV season metadata, scorecard data, parent series metadata, and episode rows. Pass exactly one of `path` or `url`.
レスポンスに関する注記
- `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ツール 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`.
レスポンスに関する注記
- `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ツール rottentomatoes_episode
関連API
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.
Rotten Tomatoesのスクレイピング方法
Rotten Tomatoesは開発者向けの公開APIを終了し、Fandango経由でデータをライセンス提供しています。Crawloraの24エンドポイントは公開ページから映画の一括詳細、スコア、レビュー、批評家・出版元の情報を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, then use `/rottentomatoes/critic/publications` with a returned critic path to discover publication names and encrypted IDs. Those IDs open publication profiles and newest-first review samples. For coverage discovery, list current child sitemaps, then page one named sitemap; URL results omit paths excluded by robots rules.
Use `/rottentomatoes/movies` with 1–20 paths from search or 1–20 `ems_id` values returned by Rotten Tomatoes endpoints. Pass exactly one of `paths` or `ids`; the response preserves request order and includes title, release, score, consensus, and watch-offer fields, but review rows remain on the dedicated review routes.
Take `encrypted_publication_id` from `/rottentomatoes/critic/publications` or a returned review row and pass it to `/rottentomatoes/publication` or `/rottentomatoes/publication/reviews`. Publication reviews are newest-first, accept a maximum `limit` of 20, and resume from `data.page_info.end_cursor` with the same limit; numeric publication IDs are not accepted by the review feed. Responses include review excerpts and source links, not article bodies.
On 2026-10-30 /rottentomatoes/browse/movies for movies_in_theaters returned 10 items with page_info cursors and a list title of Best Movies in Theaters with an HTML span for the year, and browse/tv returned 10 items under Best TV Shows (October 2026). Clean list titles before display; browse/filters for movies_at_home returned 6 filters.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Rotten Tomatoes のデータを JSON として取得できます。Rotten Tomatoes に対応するスキル:
Researches movies and TV titles across IMDb, TMDB, JustWatch, Rotten Tomatoes, and Metacritic using the Crawlora API. Use for title discovery, cast…
npx skills add github.com/Crawlora-org/crawlora-skills --skill entertainment-discovery-researchResearches movies and TV shows — metadata, cast/crew, ratings, reviews, streaming availability, and box-office performance — via the Crawlora API…
npx skills add github.com/Crawlora-org/crawlora-skills --skill movie-tv-researchFAQ
公開の公式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.
Resolve its encrypted_publication_id from `/rottentomatoes/critic/publications` or a review row, then pass it to `/rottentomatoes/publication/reviews`. The feed is newest-first, returns up to 20 review excerpts, and uses its returned cursor for the next page; it does not provide the linked article body.