トマトメーター指数と観客評価の収集
Rotten Tomatoesエンドポイントを使えば、「トマトメーター指数と観客評価の収集」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
正規化JSONを使って、Rotten Tomatoesの映画、シリーズ、シーズン、エピソード詳細(トマトメーター指数と観客評価を含む)、批評家・観客レビュー、出演者・スタッフ情報、閲覧リストを収集し、カタログとリサーチに活用できます。
公開ページから、Rotten Tomatoesの映画・シリーズの評価、批評、コメント、シーズン、エピソード、人物データを構造化JSONとして抽出できます。
エンドポイントファミリー
6
ドキュメント化されたパラメータ
92
サンプル数
20
ライブカタログスナップショット
稼働エンドポイント
20
メソッド
GET
必須パラメータ
27
スキーマ参照
20
{
"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エンドポイントカタログから取得しています(エンドポイント20件、ドキュメント化されたリクエストパラメータ92個、公開レスポンススキーマ20件)。DocsとPlaygroundが参照しているカタログと同じものです。
Rotten Tomatoesのエンドポイントは20件、11つのリクエストファミリーに分類されています(Editorial、Browse、Movieほか8件)。
これらのRotten Tomatoesエンドポイントには92個のリクエストパラメータがドキュメント化されており、うち27個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
20件のRotten Tomatoesエンドポイントのうち20件が実際のサンプルレスポンスを、20件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Rotten Tomatoesのエンドポイントは成功時のスキーマに加えてエラーレスポンス(400、404、429、500、503)もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Rotten Tomatoesのエンドポイントは20個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/rottentomatoes/editorial/content
/rottentomatoes/browse/movies
/rottentomatoes/movie
/rottentomatoes/critics/authors
/rottentomatoes/episode
/rottentomatoes/person
主要エンドポイント
/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/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. - 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
/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`.
レスポンスに関する注記
- `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ツール rottentomatoes_movie_reviews
関連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は開発者への公開アクセスを廃止し、現在は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.