Box office chart collection
Use Box Office Mojo endpoints to turn box office chart collection into repeatable API requests with documented inputs and JSON responses.
Media & Streaming21 active endpointsapiKey
Box Office Mojo Scraper API
Collect Box Office Mojo lifetime grosses, domestic and worldwide yearly charts, weekend box office, release and title detail, franchises, brands, and genres as normalized JSON for box-office dashboards and research.
Extract Box Office Mojo lifetime grosses, yearly and weekend charts, releases, franchises, and genres as structured JSON from public pages.
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
Extract Box Office Mojo lifetime grosses, yearly and weekend charts, releases, franchises, and genres as structured JSON from public pages.
Title and release gross tracking
Use Box Office Mojo endpoints to turn title and release gross tracking into repeatable API requests with documented inputs and JSON responses.
Franchise and genre analysis
Use Box Office Mojo endpoints to turn franchise and genre analysis 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 media & streaming 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 is the standard public record for theatrical grosses and it has no developer API. Crawlora's 21 Box Office Mojo endpoints return lifetime gross charts, yearly and weekend box office, daily grosses, title and release detail, franchises, brands, genres, and the release calendar as normalized JSON.
- Step 1
Start from a chart
Lifetime grosses take an area of worldwide or domestic with an offset; yearly charts take a year; weekend charts take a year and a week.
- Step 2
Open a title or release
Title, release, and release-group endpoints each take an id, a path, or a url.
- Step 3
Slice by franchise, brand, or genre
Chart endpoints list franchises, brands, and genres sorted by total gross, release count, or gross-to-date, and the detail variants page through each one's releases.
- Step 4
Track the calendar
The calendar endpoints cover the domestic release schedule by year and month, by a specific date, and a changes feed for schedule moves.
FAQ
Scraping Box Office Mojo: common questions
Is there a Box Office Mojo API?
No. Box Office Mojo, which IMDbPro operates, publishes its charts as web pages with no developer API. Crawlora's endpoints read those credential-free public pages and return the same figures as structured JSON.
Can I get worldwide as well as domestic grosses?
Yes. The lifetime-gross chart takes an area of worldwide or domestic, and there are separate yearly endpoints for each. Weekend, daily, and by-distributor breakdowns are domestic.
How do I pull a specific weekend?
The weekend endpoints take a year and a week number. Three variants exist: the standard weekend chart, a by-distributor split, and the estimates feed that publishes before final figures land.
What can I address a title by?
An id, a path, or a full url — whichever you already have. Chart rows return the identifiers, so the normal flow is chart first, then detail.