トマトメーター指数と観客評価の収集
Rotten Tomatoesエンドポイントを使えば、「トマトメーター指数と観客評価の収集」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
正規化JSONを使って、Rotten Tomatoesの映画、シリーズ、シーズン、エピソード詳細（トマトメーター指数と観客評価を含む）、批評家・観客レビュー、出演者・スタッフ情報、閲覧リストを収集し、カタログとリサーチに活用できます。
公開ページから、Rotten Tomatoesの映画・シリーズの評価、批評、コメント、シーズン、エピソード、人物データを構造化JSONとして抽出できます。
エンドポイントファミリー
6
ドキュメント化されたパラメータ
32
サンプル数
9
ライブカタログスナップショット
稼働エンドポイント
9
メソッド
GET
必須パラメータ
10
スキーマ参照
9
{
"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エンドポイントカタログから取得しています（エンドポイント9件、ドキュメント化されたリクエストパラメータ32個、公開レスポンススキーマ9件）。DocsとPlaygroundが参照しているカタログと同じものです。
Rotten Tomatoesのエンドポイントは9件、7つのリクエストファミリーに分類されています（Browse、Movie、Episodeほか4件）。
これらのRotten Tomatoesエンドポイントには32個のリクエストパラメータがドキュメント化されており、うち10個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
9件のRotten Tomatoesエンドポイントのうち9件が実際のサンプルレスポンスを、9件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Rotten Tomatoesのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Rotten Tomatoesのエンドポイントは9個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/rottentomatoes/browse/movies
/rottentomatoes/movie
/rottentomatoes/episode
/rottentomatoes/person
/rottentomatoes/search
/rottentomatoes/season
エンドポイントカタログ
/rottentomatoes/searchReturns normalized Rotten Tomatoes movie search rows from credential-free server-rendered search HTML.
レスポンスに関する注記
- Returns normalized movie rows parsed from credential-free Rotten Tomatoes search HTML. - A true no-results page returns an empty `results` array. Challenge pages or parser drift return an upstream error. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "inception", "limit": 2, "results": [ { "title": "Inception", "path": "/m/inception", "url": "https://www.rottentomatoes.com/m/inception", "release_year": "2010", "tomatometer_score": 87, "tomatometer_sentiment": "POSITIVE" } ] } } ```
MCPツール rottentomatoes_search
/rottentomatoes/movieReturns normalized Rotten Tomatoes movie metadata, scorecard data, and representative embedded 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. - Upstream challenge pages, malformed page data, or parser drift are returned as typed upstream errors. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Inception", "path": "/m/inception", "url": "https://www.rottentomatoes.com/m/inception", "media_type": "Movie", "critics_score": { "score_percent": "87%" }, "audience_score": { "score_percent": "91%" }, "public_page_derived": true } } ```
MCPツール rottentomatoes_movie
/rottentomatoes/seriesReturns normalized Rotten Tomatoes TV series metadata and scorecard data from a credential-free public series page. 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Breaking Bad", "path": "/tv/breaking_bad", "url": "https://www.rottentomatoes.com/tv/breaking_bad", "media_type": "TvSeries", "number_of_seasons": 5, "critics_score": { "score_percent": "96%" }, "audience_score": { "score_percent": "97%" }, "public_page_derived": true } } ```
MCPツール rottentomatoes_series
/rottentomatoes/seasonReturns normalized Rotten Tomatoes TV season metadata, scorecard data, parent series metadata, and episode rows from a credential-free public season page. 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Season 1", "path": "/tv/breaking_bad/s01", "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01", "media_type": "TvSeason", "parent_series": { "title": "Breaking Bad", "path": "/tv/breaking_bad" }, "episode_count": 7, "critics_score": { "score_percent": "86%" }, "audience_score": { "score_percent": "95%" }, "public_page_derived": true } } ```
MCPツール rottentomatoes_season
/rottentomatoes/episodeReturns normalized Rotten Tomatoes TV episode metadata, scorecard data, parent series/season metadata, and public video metadata from a credential-free public episode page. 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Pilot", "path": "/tv/breaking_bad/s01/e01", "url": "https://www.rottentomatoes.com/tv/breaking_bad/s01/e01", "ems_id": "ccda9549-4dcb-3147-9a2b-1106dcf852f7", "media_type": "TvEpisode", "parent_series": { "title": "Breaking Bad", "path": "/tv/breaking_bad" }, "parent_season": { "title": "Season 1", "path": "/tv/breaking_bad/s01", "season_number": 1 }, "season_number": 1, "episode_number": 1, "air_date": "2008-01-20", "video": { "title": "Breaking Bad: Official Clip - Walter Wants to Cook" }, "public_page_derived": true } } ```
MCPツール rottentomatoes_episode
/rottentomatoes/movie/reviewsReturns normalized critic or audience reviews from Rotten Tomatoes public review JSON hydrated by the movie review page, including pagination metadata. Pass exactly one of `path` or `url`. Supported `type` values are `critics`, `top-critics`, `audience`, and `verified-audience`.
レスポンスに関する注記
- `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. Example response: ```json { "code": 200, "msg": "OK", "data": { "type": "critics", "limit": 10, "page_info": { "has_next_page": true, "end_cursor": "eyJ0eXBlIjoiUmV2aWV3In0" }, "reviews": [ { "display_name": "Danilo Castro", "review": "A representative review excerpt." } ], "public_page_derived": true } } ```
MCPツール rottentomatoes_movie_reviews
/rottentomatoes/browse/moviesReturns normalized movie rows from Rotten Tomatoes public browse pages using credential-free JSON-LD ItemList data. Supported `list` values are `movies_in_theaters`, `movies_at_home`, and `movies_coming_soon`. Supported `sort` values are `popular`, `newest`, and `top_box_office`; `top_box_office` is only valid with `movies_in_theaters`.
レスポンスに関する注記
- `data.public_page_derived` is `true`. - `items` contains public JSON-LD rows with title, path, image, release/date text, Tomatometer score/count when available, and trailer metadata when present. - Browse pages that stop exposing JSON-LD `ItemList` rows return typed upstream errors instead of `200 []`. Example response: ```json { "code": 200, "msg": "OK", "data": { "list": "movies_in_theaters", "sort": "popular", "limit": 3, "title": "Movies Out Now in Theaters (2026)", "items": [ { "position": 1, "media_type": "Movie", "title": "Wildwood, NJ", "path": "/m/wildwood_nj", "url": "https://www.rottentomatoes.com/m/wildwood_nj", "date_created": "1994" } ], "public_page_derived": true } } ```
MCPツール rottentomatoes_browse_movies
/rottentomatoes/browse/tvReturns normalized TV series rows from Rotten Tomatoes public browse pages using credential-free JSON-LD ItemList data. Supported `list` value is `tv_series_browse`. Supported `sort` values are `popular` and `newest`.
レスポンスに関する注記
- `data.public_page_derived` is `true`. - `items` contains public JSON-LD rows with title, path, image, start/date text, Tomatometer score/count when available, and trailer metadata when present. - Browse pages that stop exposing JSON-LD `ItemList` rows return typed upstream errors instead of `200 []`. Example response: ```json { "code": 200, "msg": "OK", "data": { "list": "tv_series_browse", "sort": "popular", "limit": 3, "title": "Best TV Shows (June 2026)", "items": [ { "position": 1, "media_type": "TVSeries", "title": "Spider-Noir", "path": "/tv/spider_noir", "url": "https://www.rottentomatoes.com/tv/spider_noir", "date_created": "2026-05-27", "tomatometer_score": 91, "critics_review_count": 96 } ], "public_page_derived": true } } ```
MCPツール rottentomatoes_browse_tv
/rottentomatoes/personReturns normalized Rotten Tomatoes celebrity/person metadata and filmography rows from public Person JSON-LD and the credential-free filmography module. Pass exactly one of `path` or `url`.
レスポンスに関する注記
- `data.public_page_derived` is `true`. - `highest_rated` and `lowest_rated` are included only when the public bio panel exposes those title links and scores. - `filmography` rows prefer the embedded filmography module because it includes credits plus critic and audience score summaries. - Blocked pages, malformed page data, or missing person/filmography markers return typed upstream errors. Example response: ```json { "code": 200, "msg": "OK", "data": { "name": "Christopher Nolan", "path": "/celebrity/christopher_nolan", "url": "https://www.rottentomatoes.com/celebrity/christopher_nolan", "ems_id": "a015d515-713e-38e3-abbe-cf0cdaa519b0", "birth_date": "1970-07-30", "birthplace": "London, England, UK", "highest_rated": { "title": "The Dark Knight", "path": "/m/the_dark_knight", "score": 94, "year": "2008" }, "filmography": [ { "title": "Oppenheimer", "path": "/m/oppenheimer_2023", "credits": "Director, Screenwriter, Producer", "critics_score": { "score_percent": "93%" } } ], "public_page_derived": true } } ```
MCPツール rottentomatoes_person
関連API
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Media & Streaming
Turn Apple Books ebook and audiobook pages into structured data — search, catalog detail, paginated customer reviews, similar titles, author bibliographies, series listings, and chart rankings as normalized JSON. Credential-free.
Media & Streaming
Search public Ticketmaster events and browse the full discovery hierarchy by category or city, with pagination plus event, attraction, and venue detail endpoints -- including fan reviews, related attractions, trending attractions, and enhanced venue branding -- for live-entertainment research.
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でソートできます。シリーズの閲覧はシリーズ一覧をカバーします。
FAQ
公開の公式APIはありません。Rotten Tomatoesは開発者への公開アクセスを廃止し、現在はFandangoとの提携を通じてデータをライセンス提供しています。CrawloraはRotten Tomatoesと提携関係にありません。そのエンドポイントは認証不要の公開ページを読み取り、評価とレビューをJSONとして返します。
できます。作品詳細には、批評家のトマトメーター指数と観客評価に加え、映画・シリーズ・シーズン・エピソードの出演者・スタッフ情報も返されます。
レビューエンドポイントのtypeパラメータはcritics、top-critics、audience、verified-audienceを受け付けるため、各グループは独立した呼び出しであり、クライアント側でのフィルタリングではありません。
Rotten Tomatoesのpathまたは完全なurlです。検索がpathを返すため、通常のフローはまず検索し、次にpathを詳細またはレビューエンドポイントに渡すというものです。