Every Box Office Mojo chart and film gross, as JSON
Box Office Mojo (by IMDbPro) publishes the box office record: what every film earned on each day, weekend and week, in the US and Canada and in 113 other markets.
- endpoints
- 29
- credits per call
- 0–1
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
- tt0499549
- position
- 1
- title
- Avatar
- year
- 2009
- tt1757678
- position
- 2
- title
- Avatar: Fire and Ash
- year
- 2025
- tt3095356
- position
- 3
- title
- Avatar 4
- year
- 2029
29 active endpoints, on 0 and 1 credit tiers.
- POST/boxofficemojo/v1/search1 credit
- POST/boxofficemojo/v1/title1 credit
- POST/boxofficemojo/v1/title_credits1 credit
- POST/boxofficemojo/v1/release_group1 credit
- POST/boxofficemojo/v1/release1 credit
- POST/boxofficemojo/v1/rankings1 credit
- POST/boxofficemojo/v1/daily_chart1 credit
- POST/boxofficemojo/v1/weekend_chart1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Box Office Mojo API
5 of 29 endpoints, ready to run
One weekend's box office chart, any market
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Box Office Mojo endpoints does ReefAPI ship?
29 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Box Office Mojo endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Box Office Mojo API works
Box Office Mojo is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From last weekend's chart to each film's full run
Read a weekend, then open every film in it.
Every weekend of the year with its total gross, #1 film and the weekend_id to open it.
All films that played that weekend: rank, gross, drop, theaters, average, total, distributor.
One film's run day by day, with the release id of the same film in every other market.
The film's worldwide total, budget, rating, genres and lifetime gross in every market.
A weekend report with each film's daily trend and its international performance, from four calls.
curl -X POST https://api.reefapi.com/boxofficemojo/v1/weekend_chart \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"weekend":"2025W45"}'{
"ok": true,
"data": { … },
"meta": {
"api": "boxofficemojo",
"endpoint": "weekend_chart",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Box Office Mojo field actually contains
Fields that read differently from how they look. Every row was measured against live boxofficemojo.com pages on 2026-11-16.
| Field | What it holds |
|---|---|
| *_usd | Every gross is in US dollars, for every market: Box Office Mojo converts local grosses to dollars itself (the French 2025 chart prints Avatar: Fire and Ash at $63,918,244). |
| gross_usd vs total_gross_usd | In a period chart, gross_usd is what the film earned inside that period (the site's "calendar grosses") and total_gross_usd is its whole run to date. grosses=total ranks by the whole run instead. |
| weekend_gross_usd / daily_gross_usd | The page's "Gross" column, named after the period it covers. Each row's weekend gross, rank, theaters and total equalled the same weekend's row on the film's own release page in 14 of 14 checks. |
| release_date / release_date_text | Year, month, quarter, season and holiday charts print the release date without a year ("Fri Dec 20"), and a re-released classic shows its original date (Back to the Future "Wed Jul 3" in the 2024 chart is 1985). There release_date is null and release_date_text holds what the page prints; `release` returns the exact date. Brand, franchise, genre and all-time charts print the full date and fill release_date. |
| estimated | true when the figure is still the studio's estimate rather than the reported actual. |
| title_id / release_group_id / release_id | Three levels of the same film: the film (IMDb id), one release group (original release or a re-release) and one market's release. A title's first release group equalled its release group page and its domestic release in 6 of 6 checks. |
| columns[] | Each chart response lists its columns with the page's own label ("Gross", "%± LW", "Avg") next to the field name, so every number can be traced to the column it came from. |
| genre / budget_usd / running_time in charts | The site keeps these columns in its chart tables but prints "-" in them (0 of 4,324 year and period chart rows measured); budget, running time and genres come from `title` and `release`. |
Person and company box-office pages are on IMDbPro, which needs a subscription; they are not part of this API. Cast and crew names with their IMDb person ids come from `title_credits`.
Box Office Mojo coverage, measured
Every number below was read from live boxofficemojo.com on 2026-11-16: 248 calls over 29 actions, 248 answered, plus 46 checks that wrong inputs get the right error.
Weekend charts for the US and Canada and 113 markets; daily and weekly charts for the US and Canada; year charts from 1977; 34 all-time charts. 2019 weekend 17 listed 114 films, 2025 had 365 daily rows and 60 weekends.
A film's total gross and widest theater count in the year chart equalled its own release page for 16 of 16 films; weekend rows (gross, rank, theaters, total) equalled the film's weekend run in 14 of 14; a title's release group, its group page and its domestic release agreed in 6 of 6; numbers read independently from the same pages agreed in 304 of 304 cells; search results opened the same film in 14 of 14.
Titanic: 6 release groups and 75 markets; Avatar: The Way of Water: 49 markets; A Minecraft Movie: 35 market releases. Budgets are published for major films (Avatar: The Way of Water $460,000,000) and missing for many smaller ones.
All-time charts run 200 rows a page; the domestic top lifetime grosses list ends at rank 20,224 (page 102). Genre keyword lists run 100 a page; release-date changes 30 a page.
A year chart prints at most 200 films per sort order (2025: 670 releases; ascending order gives the bottom 200). Search returns one page of up to 54 titles. Daily and weekly charts exist for the US and Canada only. Person and company box-office pages are on IMDbPro and not included.
What people build with Box Office Mojo
The jobs this data is most often used for.
endpoints
credits per call
Track the weekend box office every Monday: rank, gross, drop and per-theater average for every film in release.
Compare a film's opening and run across the US and international markets for distribution and marketing decisions.
Build historical datasets of yearly, monthly and holiday box office back to 1977 for forecasting models.
Benchmark a franchise or a studio brand: every film's lifetime gross, opening and widest release.
What Box Office Mojo data costs
The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/boxofficemojo/v1/weekend_chart \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"weekend":"2025W45"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/boxofficemojo/v1/weekend_chart",
headers={"x-api-key": REEF_KEY},
json={
"weekend": "2025W45"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Box Office Mojo.
Can I get the weekend box office for any market, not only the US?▾
Yes. `weekend_chart` takes `area` with a market code or name (GB, France, JP, China…); `areas` lists the 113 markets plus Domestic, Worldwide and International. Daily and weekly charts exist for Domestic (US & Canada) only: the site prints no daily or weekly table for other markets.
How far back does the data go?▾
Domestic year charts start in 1977, and the yearly index lists every year with its total gross, number of releases and #1 film. All-time charts go deep: the domestic top lifetime grosses list runs to rank 20,224, 200 rows per page.
How many films does a year chart return?▾
The site prints at most 200 films per sort order. 2025 had 670 domestic releases; sort=gross with sort_dir=asc returns the bottom 200, and month or quarter charts (up to 200 rows each) cover the rest.
Does it return a film's worldwide gross and the split by country?▾
Yes. `title` returns domestic, international and worldwide gross with each share, and every market's lifetime gross with the film's all-time rank there (Titanic: 75 markets). `release_group` lists each market's release date, opening weekend and gross.
Can I get a film's day-by-day box office?▾
Yes. `release` with view=daily returns every day of the run: rank, gross, change against the previous day and the same day last week, theaters, per-theater average, gross to date and day number. view=weekend and view=weekly give the weekend and weekly runs.
Are budgets included?▾
Where Box Office Mojo publishes one: `title` and `release` return budget_usd (Avatar: The Way of Water $460,000,000, A Minecraft Movie $150,000,000). Many smaller films have no published budget, and the field is null for them.
How do I find the ids?▾
`search` finds films by name and returns IMDb title ids. Every chart row carries the release_id or title_id of its film, and `year_breakdown` returns the weekend_id, week_id or date that opens each period's chart.
What is the Box Office Mojo API?▾
Box Office Mojo API is a ReefAPI endpoint group for box office mojo as json: daily, weekend, weekly, yearly and all-time box office charts for 113 markets, every film's domestic, international and worldwide gross by market, opening weekends, franchises, brands and the release calendar. It returns live JSON through POST requests under /boxofficemojo/v1.
Is the Box Office Mojo API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Box Office Mojo calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Box Office Mojo login or account?▾
No login to Box Office Mojo is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Box Office Mojo data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Box Office Mojo API use?▾
Box Office Mojo actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Box Office Mojo from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call boxofficemojo actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Box Office Mojo API a Box Office Mojo scraper?▾
It is the managed alternative to a DIY Box Office Mojo scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same box office mojo as json: daily, weekend, weekly, yearly and all-time box office charts for 113 markets, every film's domestic, international and worldwide gross by market, opening weekends, franchises, brands and the release calendar back as clean JSON.
43 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Box Office Mojo, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.