興行ランキングの収集
Box Office Mojoエンドポイントを使えば、「興行ランキングの収集」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
メディア・ストリーミング稼働中エンドポイント 21件apiKey
Box Office Mojo Scraper API
正規化JSONを使って、Box Office Mojoの歴代興行収入合計、国内・世界の年間ランキング、週末興行、公開・作品詳細、シリーズ、スタジオ、ジャンルデータを収集し、興行ダッシュボードとリサーチに活用できます。
公開ページから、Box Office Mojoの歴代興行収入合計、年間・週末興行ランキング、公開情報、シリーズ・ジャンルデータを構造化JSONとして抽出できます。
エンドポイントファミリー
6
ドキュメント化されたパラメータ
72
サンプル数
21
ライブカタログスナップショット
Box Office Mojoのカバレッジ
稼働エンドポイント
21
メソッド
GET
必須パラメータ
33
スキーマ参照
21
Calendar3
Weekend3
Year2
Brand1
{
"platform": "Box Office Mojo",
"endpoint": "boxofficemojo-lifetime-grosses",
"method": "GET",
"path": "/boxofficemojo/lifetime-grosses",
"auth": "apiKey"
}関連ユースケース
ユースケース
Box Office Mojoに適したワークフロー
公開ページから、Box Office Mojoの歴代興行収入合計、年間・週末興行ランキング、公開情報、シリーズ・ジャンルデータを構造化JSONとして抽出できます。
作品・公開ごとの興行収入トラッキング
Box Office Mojoエンドポイントを使えば、「作品・公開ごとの興行収入トラッキング」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
シリーズ・ジャンル分析
Box Office Mojoエンドポイントを使えば、「シリーズ・ジャンル分析」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
Crawloraによるこのプラットフォームの処理方法
以下の数値はすべて、稼働中のBox Office Mojoエンドポイントカタログから取得しています（エンドポイント21件、ドキュメント化されたリクエストパラメータ72個、公開レスポンススキーマ21件）。DocsとPlaygroundが参照しているカタログと同じものです。
ドキュメント化されたエンドポイント
Box Office Mojoのエンドポイントは21件、16つのリクエストファミリーに分類されています（Calendar、Weekend、Yearほか13件）。
公開されたリクエスト仕様
これらのBox Office Mojoエンドポイントには72個のリクエストパラメータがドキュメント化されており、うち33個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
判明しているレスポンス構造
21件のBox Office Mojoエンドポイントのうち21件が実際のサンプルレスポンスを、21件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
ドキュメント化されたエラー
Box Office Mojoのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
エージェントから呼べるMCPツール
Box Office Mojoのエンドポイントは21個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
統合前にAPIで収集できるデータを把握
3エンドポイント
Calendar
/boxofficemojo/calendar
GETapiKey
3エンドポイント
Weekend
/boxofficemojo/weekend/domestic
GETapiKey
2エンドポイント
Year
/boxofficemojo/year/domestic
GETapiKey
1エンドポイント
Brand
/boxofficemojo/brand
GETapiKey
1エンドポイント
Brands
/boxofficemojo/brands
GETapiKey
1エンドポイント
Date
/boxofficemojo/date/domestic
GETapiKey
主要エンドポイント
Box Office Mojo APIエンドポイント
GETapiKeyexample
/boxofficemojo/lifetime-grossesBox Office Mojo lifetime gross chart
Returns one page of Box Office Mojo's lifetime gross chart of movies. `area` is `worldwide` (default) or `domestic`, and `offset` pages in steps of 200 from 0 to 800. Each row has `rank`, `title`, `title_id`, `year` and `lifetime_gross` as an integer, with the displayed text in `lifetime_gross_raw`.
レスポンスに関する注記
- `data.public_page_derived` is `true`. - `lifetime_gross` is a parsed integer when the page exposes a money value; `lifetime_gross_raw` keeps the visible upstream text. - Upstream challenge pages, malformed table data, or parser drift are returned as typed upstream errors.
MCPツール boxofficemojo_lifetime_grosses
area:queryoffset:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/year/domesticBox Office Mojo domestic yearly box office
Returns the Box Office Mojo domestic box office chart for one year. `year` is required and runs from 1977 to 2100. Each row has `rank`, `release`, `release_date`, `distributor`, `theaters`, `gross`, `total_gross` and `new_this_year`, each gross also with its displayed text in a `_raw` field.
レスポンスに関する注記
- The response includes the requested year, `grosses_option`, source URL, fetch time, and domestic yearly rows. - Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload.
MCPツール boxofficemojo_year_domestic
year:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/year/worldwideBox Office Mojo worldwide yearly box office
Returns the Box Office Mojo worldwide box office chart for one year. `year` is required and runs from 1977 to 2100. Each row is a release group with its `rank`, `worldwide`, `domestic` and `foreign` grosses, the domestic and foreign shares, and `title_id`; each gross also has its displayed text in a `_raw` field.
レスポンスに関する注記
- The response includes the requested year, source URL, fetch time, and yearly box office rows. - Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload.
MCPツール boxofficemojo_year_worldwide
year:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/weekend/domesticBox Office Mojo domestic weekend box office
Returns rows from Box Office Mojo's domestic weekend chart. Empty upstream weekend pages return a typed not-found error rather than an empty success.
レスポンスに関する注記
- The response includes the requested year/week, date range when present, source URL, fetch time, and weekend rows. - Empty upstream weekend pages return a typed not-found error rather than an empty success payload. - Parser drift, challenge pages, or malformed upstream tables return an upstream error.
MCPツール boxofficemojo_weekend_domestic
year:queryweek:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/titleBox Office Mojo title detail
Returns Box Office Mojo title release-group and market-gross tables from a title page. Pass exactly one of `id`, `path`, or `url`.
レスポンスに関する注記
- `data.public_page_derived` is `true`. - `release_groups` contains rollout-level domestic, international, and worldwide grosses. - `market_grosses` contains the visible regional market tables when present. - Upstream challenge pages, malformed table data, missing title markers, or parser drift are returned as typed upstream errors.
MCPツール boxofficemojo_title
id:querypath:queryurl:query他1件
GETapiKeyexample
/boxofficemojo/releaseBox Office Mojo release detail
Returns Box Office Mojo release summary fields and domestic daily rows from a release page. Pass exactly one of `id`, `path`, or `url`.
レスポンスに関する注記
- The response includes title, release id, source URL, summary fields, and domestic daily rows. - Parser drift, challenge pages, malformed upstream tables, or missing required release markers return an upstream error.
MCPツール boxofficemojo_release
id:querypath:queryurl:query他1件
関連API
メディア・ストリーミングのその他のカバレッジ
Media & Streaming
FUSSBALL.DE
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
Sportskeeda
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
JustWatch
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Box Office Mojoのスクレイピング方法
4ステップでBox Office Mojoのデータを抽出
Box Office Mojoは映画館の興行収入に関する標準的な公開記録源であり、開発者向けAPIはありません。Crawloraの21個のBox Office Mojoエンドポイントは、歴代興行収入ランキング、年間・週末興行収入、日別興行収入、作品・公開詳細、シリーズ、スタジオ、ジャンル、公開カレンダーデータを正規化JSONとして返します。
- ステップ 1
ランキングから始める
歴代興行収入合計はarea（worldwideまたはdomestic）パラメータとoffsetを、年間ランキングはyearパラメータを、週末ランキングはyearとweekパラメータを受け付けます。
- ステップ 2
作品または公開情報を開く
作品、公開、公開グループの各エンドポイントは、それぞれid、path、urlを受け付けます。
- ステップ 3
シリーズ・スタジオ・ジャンル別に分解する
ランキングエンドポイントは、興行収入合計・公開本数・累計興行収入でシリーズ、スタジオ、ジャンルをソートして一覧表示し、詳細バリアントはそれぞれの公開作品をページ分割して表示します。
- ステップ 4
カレンダーを追跡する
カレンダーエンドポイントは、年・月別、特定日別の国内公開日程と、日程変更を記録する変更フィードをカバーします。
FAQ
Box Office Mojoのスクレイピング：よくある質問
Box Office Mojo APIはありますか？
ありません。IMDbProが運営するBox Office Mojoは、ランキングをウェブページとして公開しており、開発者向けAPIはありません。Crawloraのエンドポイントは、認証不要のこれらの公開ページを読み取り、同じデータを構造化JSONとして返します。
世界興行収入と国内興行収入の両方を取得できますか？
できます。歴代興行収入合計ランキングはarea（worldwideまたはdomestic）パラメータを受け付け、それぞれ独立した年間エンドポイントがあります。週末・日別・配給会社別のデータはすべて国内（domestic）データです。
特定の週末の興行収入を照会するには？
週末エンドポイントはyearとweekパラメータを受け付けます。標準の週末ランキング、配給会社別、最終データ公開前の推定値フィードの3種類のバリアントがあります。
特定の作品を特定するにはどうすればよいですか？
id、path、または完全なurlのいずれかを使用します（すでにどれを持っているかによります）。ランキング行自体にこれらの識別子が含まれるため、通常のフローはまずランキングを照会し、次に詳細を照会するというものです。