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
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 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`.
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.
Sampled 14 Oct 2026: 200 items, 8 fields filled in every item. rank: 1 to 200, median 100; title: “Avengers: Endgame” and 198 other values.
MCP tool 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.
Response notes
- 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.
Sampled 14 Oct 2026: 200 items, 12 fields filled in every item. rank: 1 to 200, median 100; release: “A Minecraft Movie” and 199 other values.
MCP tool 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.
Response notes
- 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.
Sampled 14 Oct 2026: 200 items, 9 fields filled in every item, 4 not. rank: 1 to 200, median 100; release_group: “Ne Zha 2” and 199 other values.
MCP tool 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.
Response notes
- 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.
Sampled 14 Oct 2026: 48 items, 16 fields filled in every item, 3 not. rank: 1 to 48, median 24; release: “Avatar: Fire and Ash” and 47 other values.
MCP tool 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`.
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.
Sampled 14 Oct 2026: 6 items, 8 fields filled in every item, 3 not. domestic: 10,741,486 to 749,766,139, median 24,714,024; name: “Original Release” and 5 other values.
MCP tool boxofficemojo_title
id:querypath:queryurl:query+1 more
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`.
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.
Sampled 14 Oct 2026: 119 items, 11 fields filled in every item, 2 not. day_of_week: Friday (17), Saturday (17), Sunday (17) and 4 more; rank: 1 to 24, median 8.
MCP tool boxofficemojo_release
id:querypath:queryurl:query+1 more
Related APIs
More media & streaming coverage
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.
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.