Box Office Mojo API & Scraper
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.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API returns those tables as JSON. `weekend_chart` gives one weekend's chart (rank, last week's rank, weekend gross, change, theaters, per-theater average, total gross, weeks in release, distributor), with the Sunday studio estimates against the actuals and the totals per distributor. `daily_chart`, `weekly_chart`, `year_chart`, `period_chart` (month, quarter, season, holiday) and `worldwide_year_chart` cover the other periods; `year_breakdown` lists a year's days, weekends, weeks, months, quarters, seasons or holidays with the #1 film of each. `title` returns a film's domestic, international and worldwide gross, budget where published, MPA rating, running time, genres, every release group and the lifetime gross and rank in every market; `release` returns one market's run day by day, weekend by weekend or week by week. `all_time_chart` opens 34 all-time charts (top lifetime grosses, top openings, fastest to $100M-$900M, biggest drops and holds, widest releases), and `brands`, `franchises`, `genres`, `showdowns`, `calendar` and `schedule_changes` cover the rest of the site.
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`.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/boxofficemojo/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "avatar"
}
}{
"ok": true,
"meta": {
"api": "boxofficemojo",
"endpoint": "search",
"mode": "live",
"latency_ms": 980,
"record_count": 14,
"bytes": 144799,
"cache_hit": false,
"upstream_requests": 1,
"source_url": "https://www.boxofficemojo.com/search/?q=avatar",
"charged_credits": 1,
"version": "0.1.0",
"request_id": "0e1b15556cb74f68",
"fetched_at": "2026-11-16T21:05:21.936Z"
},
"data": {
"query": "avatar",
"results": [
{
"position": 1,
"title_id": "tt0499549",
"title": "Avatar",
"year": 2009,
"genres": [
"Action",
"Adventure",
"Fantasy"
],
"cast": [
"Sam Worthington",
"Zoe Saldaña",
"Sigourney Weaver"
],
"poster_url": "https://m.media-amazon.com/images/M/MV5BMDEzMmQwZjctZWU2My00MWNlLWE0NjItMDJlYTRlNGJiZjcyXkEyXkFqcGc@._V1_SX132_CR0,0,132,192_.jpg",
"url": "https://www.boxofficemojo.com/title/tt0499549/"
},
{
"position": 2,
"title_id": "tt1757678",
"title": "Avatar: Fire and Ash",
"year": 2025,
"genres": [
"Action",
"Adventure",
"Drama"
],
"cast": [
"Sam Worthington",
"Zoe Saldaña",
"Sigourney Weaver"
],
"poster_url": "https://m.media-amazon.com/images/M/MV5BZDYxY2I1OGMtN2Y4MS00ZmU1LTgyNDAtODA0MzAyYjI0N2Y2XkEyXkFqcGc@._V1_SX132_CR0,0,132,192_.jpg",
"url": "https://www.boxofficemojo.com/title/tt1757678/"
},
{
"position": 3,
"title_id": "tt3095356",
"title": "Avatar 4",
"year": 2029,
"genres": [
"Action",
"Adventure",
"Fantasy"
],
"cast": [
"Zoe Saldaña",
"Jemaine Clement",
"Sigourney Weaver"
],
"poster_url": "https://m.media-amazon.com/images/M/MV5BZDFhYzVjZjgtYTlkZC00YmQ0LWFhNmMtM2EwNDRlZmZiYmFmXkEyXkFqcGc@._V1_SY192_CR30,0,132,192_.jpg",
"url": "https://www.boxofficemojo.com/title/tt3095356/"
}
],
"count": 14
}
}What the Box Office Mojo API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Box Office Mojo titles by name. Each row is a film (IMDb title id) with its year, genres, the top-billed cast the site prints and a poster. Feed `title_id` to `title`. The site answers one page only (measured: `the` → 53-54 titles, `star` → 46, `avatar` → 14); there is no second page. | Content platforms call search to search Box Office Mojo titles by name. | query |
| title | One film across all its releases: domestic / international / worldwide gross (and shares), domestic distributor, domestic opening, budget (when published), earliest release date, MPA rating, running time, genres, synopsis, poster, every release group (original release, re-releases) with rollout dates and grosses, the lifetime gross and all-time rank in every market, plus the brand / franchise / genre-keyword entries the page links. A film with a single release group (no re-release) gets that group's per-market releases in `releases[]` (release id, date, opening, gross) and its totals in `summary`. | Research tools call title to get one film across all its releases. | title_id |
| title_credits | Cast and crew Box Office Mojo prints for a film (director, writers, producers, composer, cinematographer, … and the billed cast with character names), each with the IMDb person id. | Community analysts call title_credits to get cast and crew Box Office Mojo prints for a film (director, writers, producers, composer, cine…. | title_id |
| release_group | One release group of a film (e.g. the original release or a re-release): worldwide / domestic / international totals and every market's release with its release date, opening weekend and gross, grouped by region (Domestic, EMEA, Latin America, Asia Pacific, China). | Media monitors call release_group to get one release group of a film (e.g. | release_group_id |
| release | One film in one market: distributor, opening weekend gross and theaters, release and close date, MPA rating, running time, genres, widest release, the market / international / worldwide gross, and its full run day by day (rank, gross, % change vs yesterday and last week, theaters, per-theater average, gross to date, day number), weekend by weekend or week by week. `area_releases[]` lists the same film's release id in every other market. | Content platforms call release to get one film in one market. | release_id, view |
| rankings | Every all-time chart a title or a release appears on, with its rank there (e.g. Top Lifetime Grosses #8, Top Opening Weekends By Month - November #59), with the chart slug to open it via `all_time_chart`. | Research tools call rankings to get every all-time chart a title or a release appears on, with its rank there (e.g. | title_id, release_id |
| daily_chart | Every film that played on one day: rank today and yesterday, the day's gross, % change vs yesterday and vs the same day last week, theaters, per-theater average, gross to date, days in release, distributor, new-this-day and estimated flags. Domestic (US & Canada) only: the site publishes no daily chart for other markets (GB, FR, JP pages measured empty). | Community analysts call daily_chart to get every film that played on one day. | date |
| weekend_chart | One weekend's chart: rank and last week's rank, weekend gross, % change vs last weekend, theaters and change, per-theater average, total gross, weeks in release, distributor, new and estimated flags. `view=estimates` compares the Sunday studio estimate with the actual (rank, gross and total, difference and %); `view=by_distributor` gives each distributor's weekend total, market share, releases and its #1 film. | Media monitors call weekend_chart to get one weekend's chart. | weekend, area, view |
| weekly_chart | One week's (Friday-Thursday) chart: rank, weekly gross, % change, theaters, average, total gross, weeks in release, distributor. `view=weekend_vs_weekdays` splits each film's week into weekend and weekday gross with their shares; `view=by_distributor` totals per distributor. Domestic only (the site's weekly pages for other markets have no table). | Content platforms call weekly_chart to get one week's (Friday-Thursday) chart. | week, view |
| year_chart | Top films of a calendar year in a market: rank, gross in the year (or total gross with grosses=total), widest theater count, total gross, release date, distributor, estimated flag. The site prints at most 200 rows per sort (2025 Domestic has 670 releases): sort=gross with sort_dir=asc returns the bottom 200. | Research tools call year_chart to get top films of a calendar year in a market. | year, area, grosses, sort, sort_dir |
| period_chart | Top films of a month, quarter, season or holiday period of a year (same columns as `year_chart`): e.g. November 2025, Q4 2025, Summer 2024, Thanksgiving 2025, Halloween 2025. | Community analysts call period_chart to get top films of a month, quarter, season or holiday period of a year (same columns as `year_chart`). | period_type, period, year, area, grosses |
| worldwide_year_chart | Top films worldwide for a year (release groups): worldwide, domestic and international gross with each share. 200 rows (the site's ceiling). | Media monitors call worldwide_year_chart to get top films worldwide for a year (release groups). | year |
| yearly_totals | One row per year: total gross, change vs last year, number of releases, average per release and the year's #1 film (`view=totals`); year-to-date gross compared across years (`view=year_to_date`, optionally through a given month); or each year's biggest opening (`view=openings`). | Content platforms call yearly_totals to get one row per year. | view, area, grosses, through_month |
| year_breakdown | One year split into its days, weekends, weeks, months, quarters, seasons or holiday periods: top-10 and overall gross with % change, number of releases, the #1 film and its gross, and the id to open that period's chart (`date`, `weekend_id`, `week_id`, `month_slug` …). | Research tools call year_breakdown to get one year split into its days, weekends, weeks, months, quarters, seasons or holiday periods. | year, breakdown, area, grosses, daily_view |
| weekend_across_years | The same weekend number in every year (e.g. weekend 47 = Thanksgiving): dates, top-10 and overall gross with change vs last year, releases, the #1 film and long-weekend flag. | Community analysts call weekend_across_years to get the same weekend number in every year (e.g. | weekend_number, area |
| all_time_chart | One of Box Office Mojo's 34 all-time charts, paged 200 rows at a time: top lifetime grosses (domestic, worldwide, by MPA rating), top opening weekends / days / weeks, biggest Nth weekends, fastest and slowest to $100M-$900M, best and worst holds and drops, widest releases, top per-theater averages, top grossing months, never-#1 films… Pages run far past the printed 'of 1,000': domestic top lifetime grosses end at rank 20,224 (page 102, measured 2026-11-16); a page past the end returns 0 rows with has_more=false. | Media monitors call all_time_chart to get one of Box Office Mojo's 34 all-time charts, paged 200 rows at a time. | chart, variant, area, page |
| all_time_records | Box Office Mojo's record-holder index: for every all-time chart, the current #1 film and its record, with the chart slug and variant to open with `all_time_chart`. | Content platforms call all_time_records to get box Office Mojo's record-holder index. | section, area |
| brands | Brands (Marvel Comics, Pixar, DC Comics, …): total gross, number of releases, #1 release and its lifetime gross. | Research tools call brands to get brands (Marvel Comics, Pixar, DC Comics, …). | area |
| brand | Every film of one brand: rank, lifetime gross, widest theaters, opening weekend and theaters, release date, distributor. | Community analysts call brand to get every film of one brand. | brand_id, area |
| franchises | Franchises (Marvel Cinematic Universe, Star Wars, …): total gross, releases, #1 release and its lifetime gross. | Media monitors call franchises to get franchises (Marvel Cinematic Universe, Star Wars, …). | area |
| franchise | Every film of one franchise with lifetime gross, widest theaters, opening and its theaters, release date and distributor. | Content platforms call franchise to get every film of one franchise with lifetime gross, widest theaters, opening and its theaters, r…. | franchise_id, area |
| genres | Genre keywords (Adaptation, Adventure, Superhero, Time Travel, …): total gross, number of titles, #1 title and its lifetime gross. | Research tools call genres to get genre keywords (Adaptation, Adventure, Superhero, Time Travel, …). | area |
| genre | Films of one genre keyword ranked by lifetime gross (100 per page), or its upcoming titles (`view=upcoming`). | Community analysts call genre to get films of one genre keyword ranked by lifetime gross (100 per page), or its upcoming titles (`…. | genre_id, area, view, page |
| showdowns | Box Office Mojo's head-to-head comparisons (595 measured): name, number of films, combined gross, the leading film and its gross. | Media monitors call showdowns to get box Office Mojo's head-to-head comparisons (595 measured). | none |
| showdown | One showdown: for each film, genres, distributor, release date, gross to date, production budget, running time, MPA rating, domestic total, opening weekend and its share, widest release, close date, weekends at #1 and in the top 10, worldwide / international / domestic gross and shares. | Content platforms call showdown to get one showdown. | showdown_id |
| international | The latest weekend of every international market: market, weekend dates, number of releases, the #1 film, its distributor and weekend gross, grouped by weekend-ending date. | Research tools call international to get the latest weekend of every international market. | none |
| areas | The market codes this API accepts in `area` (the site's own list: 113 markets plus Domestic, Worldwide and International). No upstream call. | Community analysts call areas to get the market codes this API accepts in `area` (the site's own list. | none |
| calendar | The domestic release schedule from a date onward (about four to six weeks per page): each film with release date, distributor, scale (wide / limited / expands), genres, top-billed cast, running time and poster. | Media monitors call calendar to get the domestic release schedule from a date onward (about four to six weeks per page). | date |
| schedule_changes | Recent domestic release-date changes: film, distributor, scale, old date → new date, grouped by the day the change was recorded. 30 rows per page. | Content platforms call schedule_changes to get recent domestic release-date changes. | page |
Call search from your stack
curl -X POST https://api.reefapi.com/boxofficemojo/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"avatar"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/boxofficemojo/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "avatar"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/boxofficemojo/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "avatar"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.boxofficemojo.search with {"query":"avatar"}.Who uses this API and why
- 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.
- Watch the release calendar and its date changes to plan campaigns around competing openings.
Questions developers ask before integrating
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.