Reef AI: ask for any data. Try it
Box Office Mojo API

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

POST/boxofficemojo/v1/search200
  1. tt0499549
    position
    1
    title
    Avatar
    year
    2009
  2. tt1757678
    position
    2
    title
    Avatar: Fire and Ash
    year
    2025
  3. tt3095356
    position
    3
    title
    Avatar 4
    year
    2029
Real result, captured Nov 16, 20263 of 14
Try it live

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

View docs ↗

One weekend's box office chart, any market

1 credit1 required · 1 optional
POST/boxofficemojo/v1/weekend_chart
idle
// 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.

Try every endpoint in the playground

Endpoints

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.

29 endpoints

search

1 cr

Search Box Office Mojo titles by name.

required
query
optional
—

title

1 cr

One film across all its releases.

required
title_id
optional
—

title_credits

1 cr

Cast and crew Box Office Mojo prints for a film (director, writers, producers, composer, cine…

required
title_id
optional
—

release_group

1 cr

One release group of a film (e.g.

required
release_group_id
optional
—

release

1 cr

One film in one market.

required
release_id
optional
view

rankings

1 cr

Every all-time chart a title or a release appears on, with its rank there (e.g.

required
—
optional
title_id, release_id

daily_chart

1 cr

Every film that played on one day.

required
date
optional
—

weekend_chart

1 cr

One weekend's chart.

required
weekend
optional
area, view

weekly_chart

1 cr

One week's (Friday-Thursday) chart.

required
week
optional
view

year_chart

1 cr

Top films of a calendar year in a market.

required
year
optional
area, grosses, sort, sort_dir

period_chart

1 cr

Top films of a month, quarter, season or holiday period of a year (same columns as year_chart).

required
period_type, period, year
optional
area, grosses

worldwide_year_chart

1 cr

Top films worldwide for a year (release groups).

required
year
optional
—

yearly_totals

1 cr

One row per year.

required
—
optional
view, area, grosses, through_month

year_breakdown

1 cr

One year split into its days, weekends, weeks, months, quarters, seasons or holiday periods.

required
year, breakdown
optional
area, grosses, daily_view

weekend_across_years

1 cr

The same weekend number in every year (e.g.

required
weekend_number
optional
area

all_time_chart

1 cr

One of Box Office Mojo's 34 all-time charts, paged 200 rows at a time.

required
chart
optional
variant, area, page

all_time_records

1 cr

Box Office Mojo's record-holder index.

required
—
optional
section, area

brands

1 cr

Brands (Marvel Comics, Pixar, DC Comics, …).

required
—
optional
area

brand

1 cr

Every film of one brand.

required
brand_id
optional
area

franchises

1 cr

Franchises (Marvel Cinematic Universe, Star Wars, …).

required
—
optional
area

franchise

1 cr

Every film of one franchise with lifetime gross, widest theaters, opening and its theaters, r…

required
franchise_id
optional
area

genres

1 cr

Genre keywords (Adaptation, Adventure, Superhero, Time Travel, …).

required
—
optional
area

genre

1 cr

Films of one genre keyword ranked by lifetime gross (100 per page), or its upcoming titles (v…

required
genre_id
optional
area, view, page

showdowns

1 cr

Box Office Mojo's head-to-head comparisons (595 measured).

required
—
optional
—

showdown

1 cr

One showdown.

required
showdown_id
optional
—

international

1 cr

The latest weekend of every international market.

required
—
optional
—

areas

0 cr

The market codes this API accepts in area (the site's own list.

required
—
optional
—

calendar

1 cr

The domestic release schedule from a date onward (about four to six weeks per page).

required
—
optional
date

schedule_changes

1 cr

Recent domestic release-date changes.

required
—
optional
page

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 it works

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.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /boxofficemojo/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
0 or 1 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From last weekend's chart to each film's full run

Read a weekend, then open every film in it.

01year_breakdown?year=2025&breakdown=weekends
GET/boxofficemojo/v1/year_breakdown?year=2025&breakdown=weekends

Every weekend of the year with its total gross, #1 film and the weekend_id to open it.

02weekend_chart?weekend=2025W45
GET/boxofficemojo/v1/weekend_chart?weekend=2025W45

All films that played that weekend: rank, gross, drop, theaters, average, total, distributor.

03release?release_id=rl2417000449&view=daily
GET/boxofficemojo/v1/release?release_id=rl2417000449&view=daily

One film's run day by day, with the release id of the same film in every other market.

04title?title_id=tt31227572
GET/boxofficemojo/v1/title?title_id=tt31227572

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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "boxofficemojo",
    "endpoint": "weekend_chart",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
*_usdEvery 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_usdIn 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_usdThe 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_textYear, 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.
estimatedtrue when the figure is still the studio's estimate rather than the reported actual.
title_id / release_group_id / release_idThree 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 chartsThe 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`.

Coverage

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.

Charts

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.

Checks

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.

Films

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.

Paging

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.

Limits

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.

Use cases

What people build with Box Office Mojo

The jobs this data is most often used for.

29

endpoints

0/1

credits per call

01

Track the weekend box office every Monday: rank, gross, drop and per-theater average for every film in release.

02

Compare a film's opening and run across the US and international markets for distribution and marketing decisions.

03

Build historical datasets of yearly, monthly and holiday box office back to 1977 for forecasting models.

04

Benchmark a franchise or a studio brand: every film's lifetime gross, opening and widest release.

Pricing

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.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Same key

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.