票房榜单采集
Use Box Office Mojo endpoints to turn 票房榜单采集 into repeatable API requests with documented inputs and JSON responses.
媒体与流媒体21 active endpointsapiKey
Box Office Mojo Scraper API
以规范化 JSON 采集 Box Office Mojo 的历史总票房、国内及全球年度榜单、周末票房、上映及片名详情、系列作品、品牌和类型数据，用于票房仪表盘和研究。
从公开页面提取 Box Office Mojo 的历史总票房、年度和周末票房榜单、上映信息、系列作品及类型数据，转换为结构化 JSON。
Endpoint families
6
Documented params
72
Examples
21
Live catalog snapshot
Box Office Mojo coverage
Active endpoints
21
Methods
GET
Required params
33
Schema refs
21
Calendar3
Weekend3
Year2
Brand1
{
"platform": "Box Office Mojo",
"endpoint": "boxofficemojo-lifetime-grosses",
"method": "GET",
"path": "/boxofficemojo/lifetime-grosses",
"auth": "apiKey"
}Related use cases
Use cases
Workflows that fit Box Office Mojo
从公开页面提取 Box Office Mojo 的历史总票房、年度和周末票房榜单、上映信息、系列作品及类型数据，转换为结构化 JSON。
片名和上映票房跟踪
Use Box Office Mojo endpoints to turn 片名和上映票房跟踪 into repeatable API requests with documented inputs and JSON responses.
系列作品和类型分析
Use Box Office Mojo endpoints to turn 系列作品和类型分析 into repeatable API requests with documented inputs and JSON responses.
Managed execution
How Crawlora handles this platform
Every figure below is read from the live Box Office Mojo endpoint catalog — 21 endpoints, 72 documented request parameters, and 21 published response schemas — the same catalog Docs and Playground run against.
Documented endpoint coverage
21 documented Box Office Mojo endpoints, grouped into 16 request families — Calendar, Weekend and Year, plus 13 more.
Published request surface
72 request parameters are documented across those Box Office Mojo endpoints, 33 of them required — the full input contract is public before you write any integration code.
Known response shape
21 of the 21 Box Office Mojo endpoints ship a recorded example response, and 21 carry a documented response schema — you can code against the real JSON before the first request.
Documented failure modes
Box Office Mojo 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.
Agent-callable MCP tools
21 hosted MCP tools back the Box Office Mojo endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
Know what the API can collect before integrating
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
3 endpoints
Calendar
/boxofficemojo/calendar
GETapiKey
3 endpoints
Weekend
/boxofficemojo/weekend/domestic
GETapiKey
2 endpoints
Year
/boxofficemojo/year/domestic
GETapiKey
1 endpoints
Brand
/boxofficemojo/brand
GETapiKey
1 endpoints
Brands
/boxofficemojo/brands
GETapiKey
1 endpoints
Date
/boxofficemojo/date/domestic
GETapiKey
Featured endpoints
Box Office Mojo API endpoints
GETapiKeyexample
/boxofficemojo/lifetime-grossesBox Office Mojo lifetime gross chart
Returns normalized rows from Box Office Mojo's credential-free lifetime gross chart. `area` values: `worldwide`, `domestic`.
Response notes
- `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. Example response: ```json { "code": 200, "msg": "OK", "data": { "area": "worldwide", "offset": 0, "range": "1-200 of 1,000", "results": [ { "rank": 1, "title": "Avatar", "title_id": "tt0499549", "lifetime_gross": 2923710708, "lifetime_gross_raw": "$2,923,710,708", "year": 2009 } ], "public_page_derived": true } } ```
MCP tool boxofficemojo_lifetime_grosses
area:queryoffset:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/year/domesticBox Office Mojo domestic yearly box office
Returns normalized release rows from Box Office Mojo's public domestic yearly calendar-grosses chart.
Response notes
- The response includes the requested year, `grosses_option`, source URL, fetch time, and normalized domestic yearly rows. - Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload. Example response: ```json { "code": 200, "msg": "OK", "data": { "year": 2025, "grosses_option": "calendar_grosses", "results": [ { "rank": 1, "release": "Lilo & Stitch", "gross_raw": "$423,778,855" } ], "public_page_derived": true } } ```
MCP tool boxofficemojo_year_domestic
year:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/year/worldwideBox Office Mojo worldwide yearly box office
Returns normalized release-group rows from Box Office Mojo's public worldwide yearly chart.
Response notes
- The response includes the requested year, source URL, fetch time, and normalized yearly box office rows. - Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload. Example response: ```json { "code": 200, "msg": "OK", "data": { "year": 2025, "results": [ { "rank": 1, "release_group": "Ne Zha 2", "worldwide_raw": "$2,267,446,370" } ], "public_page_derived": true } } ```
MCP tool boxofficemojo_year_worldwide
year:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/weekend/domesticBox Office Mojo domestic weekend box office
Returns normalized rows from Box Office Mojo's public domestic weekend chart. Empty upstream weekend pages return a typed not-found error rather than an empty success.
Response notes
- The response includes the requested year/week, date range when present, source URL, fetch time, and normalized 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "year": 2025, "week": 52, "results": [ { "rank": 1, "release": "Avatar: Fire and Ash", "gross_raw": "$63,087,667" } ], "public_page_derived": true } } ```
MCP tool boxofficemojo_weekend_domestic
year:queryweek:queryx-api-key:header
GETapiKeyexample
/boxofficemojo/titleBox Office Mojo title detail
Returns normalized Box Office Mojo title release-group and market-gross tables from a public title page. Pass exactly one of `id`, `path`, or `url`.
Response notes
- `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. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Avatar", "title_id": "tt0499549", "release_groups": [ { "name": "Original Release", "markets": "77 markets", "worldwide": 2743577587, "worldwide_raw": "$2,743,577,587" } ], "public_page_derived": true } } ```
MCP tool boxofficemojo_title
id:querypath:queryurl:query+1 more
GETapiKeyexample
/boxofficemojo/releaseBox Office Mojo release detail
Returns normalized Box Office Mojo release summary fields and domestic daily rows from a public release page. Pass exactly one of `id`, `path`, or `url`.
Response notes
- 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. Example response: ```json { "code": 200, "msg": "OK", "data": { "title": "Avatar: Fire and Ash", "release_id": "rl3389031937", "summary": { "distributor": "20th Century Studios", "opening_raw": "$89,160,860" }, "daily_grosses": [ { "date": "Dec 25", "daily_gross_raw": "$24,096,415" } ], "public_page_derived": true } } ```
MCP tool boxofficemojo_release
id:querypath:queryurl:query+1 more
Related APIs
More 媒体与流媒体 coverage
Media & Streaming
JustWatch
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Media & Streaming
Apple Books
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
Ticketmaster
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.
How to scrape Box Office Mojo
Extract Box Office Mojo data in 4 steps
Box Office Mojo 是院线票房的标准公开记录来源，且没有开发者 API。Crawlora 的 21 个 Box Office Mojo 端点以规范化 JSON 返回历史总票房榜单、年度和周末票房、每日票房、片名和上映详情、系列作品、品牌、类型以及上映日历数据。
- Step 1
从一个榜单入手
历史总票房接受 worldwide 或 domestic 的 area 参数以及 offset；年度榜单接受 year 参数；周末榜单接受 year 和 week 参数。
- Step 2
打开某个片名或上映信息
片名、上映和上映组端点各自接受 id、path 或 url。
- Step 3
按系列、品牌或类型切分
榜单端点按总票房、上映数量或累计票房对系列作品、品牌和类型进行排序列出，详情变体则分页展示各自的上映记录。
- Step 4
跟踪日历
日历端点覆盖按年份和月份、按具体日期的国内上映档期，以及一个记录档期变动的变更信息流。
FAQ
Scraping Box Office Mojo: common questions
有 Box Office Mojo API 吗？
没有。由 IMDbPro 运营的 Box Office Mojo，将其榜单以网页形式发布，没有开发者 API。Crawlora 的端点读取的是这些无需凭证的公开页面，并将相同的数据返回为结构化 JSON。
我可以获取全球票房和国内票房吗？
可以。历史总票房榜单接受 worldwide 或 domestic 的 area 参数，并且各自都有独立的年度端点。周末、每日和按发行商拆分的数据均为国内数据。
如何查询某个具体的周末票房？
周末端点接受 year 和 week 参数。存在三种变体：标准周末榜单、按发行商拆分，以及在最终数据出炉前发布的预估信息流。
我可以用什么方式定位某个片名？
id、path 或完整的 url——取决于你已有哪一种。榜单行本身会返回这些标识符，因此常规流程是先查榜单，再查详情。