Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Box Office Mojo API page →
Media, Film & Knowledge

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.

29 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

Reference

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`.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/boxofficemojo/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "avatar"
  }
}
Captured response
{
  "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
  }
}
Actions

What the Box Office Mojo API does

ActionDescriptionConcrete use caseKey params
searchSearch 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
titleOne 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_creditsCast 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_groupOne 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
releaseOne 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
rankingsEvery 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_chartEvery 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_chartOne 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_chartOne 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_chartTop 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_chartTop 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_chartTop 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_totalsOne 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_breakdownOne 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_yearsThe 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_chartOne 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_recordsBox 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
brandsBrands (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
brandEvery 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
franchisesFranchises (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
franchiseEvery 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
genresGenre 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
genreFilms 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
showdownsBox 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
showdownOne 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
internationalThe 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
areasThe 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
calendarThe 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_changesRecent 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
Code samples

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.boxofficemojo.search with {"query":"avatar"}.
Use cases

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.
FAQ

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.

docs / boxofficemojo

Box Office Mojo

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.

base /boxofficemojo/v129 endpoints
post/boxofficemojo/v1/title1 credit

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`.

ParameterAllowed / rangeDescription
title_idrequired—IMDb title id (`tt…`) or a boxofficemojo.com / imdb.com title URL. From `search`, chart rows (`title_id`) or IMDb.
Try in playground →
post/boxofficemojo/v1/title_credits1 credit

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.

ParameterAllowed / rangeDescription
title_idrequired—IMDb title id (`tt…`) or a boxofficemojo.com / imdb.com title URL. From `search`, chart rows (`title_id`) or IMDb.
Try in playground →
post/boxofficemojo/v1/release_group1 credit

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).

ParameterAllowed / rangeDescription
release_group_idrequired—Release group id (`gr…`) or its URL: from `title` (`release_groups[]`), `worldwide_year_chart` rows or `release.release_group_id`.
Try in playground →
post/boxofficemojo/v1/release1 credit

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.

ParameterAllowed / rangeDescription
release_idrequired—Box Office Mojo release id (`rl…`, one film in one market) or its URL. From chart rows (`release_id`), `title`/`release_group` (`releases[]`) or `area_releases[]`.
view = dailyoptionaldaily · weekend · weeklyWhich run table to return.
Try in playground →
post/boxofficemojo/v1/rankings1 credit

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`.

ParameterAllowed / rangeDescription
title_idoptional—IMDb title id: all releases of the film.
release_idoptional—Release id: one market's release.
Try in playground →
post/boxofficemojo/v1/daily_chart1 credit

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).

ParameterAllowed / rangeDescription
daterequired—Day, YYYY-MM-DD.
Try in playground →
post/boxofficemojo/v1/weekend_chart1 credit

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.

ParameterAllowed / rangeDescription
weekendrequired—Weekend id like `2025W45` (year + W + the site's weekend number); `year_breakdown` with breakdown=weekends lists every weekend_id.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars. `by_distributor` exists for every market; `estimates` for Domestic.
view = chartoptionalchart · estimates · by_distributorWhich table.
Try in playground →
post/boxofficemojo/v1/weekly_chart1 credit

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).

ParameterAllowed / rangeDescription
weekrequired—Week id like `2025W45`; `year_breakdown` with breakdown=weeks lists every week_id.
view = chartoptionalchart · weekend_vs_weekdays · by_distributorWhich table.
Try in playground →
post/boxofficemojo/v1/year_chart1 credit

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.

ParameterAllowed / rangeDescription
yearrequired1977–Calendar year (Domestic data from 1977).
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
grosses = calendaroptionalcalendar · totalWhich gross the chart ranks by.
sort = rankoptionalrank · gross · theaters · total_gross · release_dateColumn the site sorts by.
sort_dir = descoptionaldesc · ascSort direction.
Try in playground →
post/boxofficemojo/v1/period_chart1 credit

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.

ParameterAllowed / rangeDescription
period_type = monthoptionalmonth · quarter · season · holidayKind of period.
periodrequired—Month name (`november`), quarter (`q4`), season (`winter`, `spring`, `summer`, `fall`, `holiday`) or holiday slug (`newyearsday`, `us_newyear_weekend`, `us_mlkday`, `us_mlkday_weekend`, `us_presidentsday`, `us_presidentsday_weekend`, `valentines_day`, `easter`, … the full list is in `year_breakdown` breakdown=holidays → `holiday_slug`).
yearrequired1977–Year.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars. Month and quarter charts exist for markets (FR, DE measured); season and holiday charts are Domestic only (other markets → INVALID_PARAM).
grosses = calendaroptionalcalendar · totalWhich gross the chart ranks by.
Try in playground →
post/boxofficemojo/v1/worldwide_year_chart1 credit

Top films worldwide for a year (release groups): worldwide, domestic and international gross with each share. 200 rows (the site's ceiling).

ParameterAllowed / rangeDescription
yearrequired1977–Year.
Try in playground →
post/boxofficemojo/v1/yearly_totals1 credit

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`).

ParameterAllowed / rangeDescription
view = totalsoptionaltotals · year_to_date · openingsWhich table.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
grosses = calendaroptionalcalendar · totalWhich gross the chart ranks by.
through_monthoptional—year_to_date only: cumulative through this month (`january` … `december`) instead of through today.
Try in playground →
post/boxofficemojo/v1/year_breakdown1 credit

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` …).

ParameterAllowed / rangeDescription
yearrequired1977–Year.
breakdown = weekendsoptionaldays · weekends · weeks · months · quarters · seasons · holidaysUnit of the split.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars. Markets: weekends only.
grosses = calendaroptionalcalendar · totalWhich gross the chart ranks by.
daily_view = yearoptionalyear · season · quarter · month · holiday · cumulativedays only: the site's day-list grouping.
Try in playground →
post/boxofficemojo/v1/weekend_across_years1 credit

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.

ParameterAllowed / rangeDescription
weekend_numberrequired1–53Weekend number 1-53.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
Try in playground →
post/boxofficemojo/v1/all_time_chart1 credit

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.

ParameterAllowed / rangeDescription
chartrequiredtop_lifetime_gross · ww_top_lifetime_gross · mpaa_title_lifetime_gross · never_in_top · top_opening_day · release_top_daily_gross · release_top_holiday_gross · release_top_daily_gross_by_dow · top_non_opening_by_dow · top_opening_weekend · release_top_opn_wkd_in_month · release_top_opn_wkd_in_season · top_opening_wknd_by_mpaa · top_release_gross_nth_weekend · smallest_second_weekend_gross_drop · top_opening_holiday_weekends · top_thanksgiving_openings · release_top_weekend_gross · most_theaters_opening · most_theaters · top_opening_weekend_theater_avg · top_weekend_theater_avg · biggest_second_weekend_gross_drop · post_thanksgiving_weekend_drop · btm_wide_opening_weekend_theater_avg · worst_release_opening · biggest_third_weekend_num_theaters_drop · top_opening_week · fastest_to_milestone · slowest_to_milestone · top_grossing_month · top_release_gtd_nth_day · mpaa_opening_wknds_by_num_theaters · mpaa_by_max_theatersChart slug (from `all_time_records` or `rankings`).
variantoptional—The chart's sub-list where it has one: MPA rating (`G`, `G/PG`, `PG`, `PG-13`, `R`, `NC-17`), month / season / holiday / weekday, Nth weekend or day (2-12), milestone in dollars (`100000000`), release scale (`wide`, `very_wide`, …), studio type, rank threshold (`1`, `5`, `10`). Default: the chart's first.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars. Lifetime charts: Domestic or XWW; other charts as the site offers (an area the chart does not have → INVALID_PARAM).
page = 1optional1–500Page of the chart (the site serves 200 rows per page).
Try in playground →
post/boxofficemojo/v1/all_time_records1 credit

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`.

ParameterAllowed / rangeDescription
section = overalloptionaloverall · weekend · daily · miscIndex page.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
Try in playground →
post/boxofficemojo/v1/brands1 credit

Brands (Marvel Comics, Pixar, DC Comics, …): total gross, number of releases, #1 release and its lifetime gross.

ParameterAllowed / rangeDescription
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
Try in playground →
post/boxofficemojo/v1/brand1 credit

Every film of one brand: rank, lifetime gross, widest theaters, opening weekend and theaters, release date, distributor.

ParameterAllowed / rangeDescription
brand_idrequired—Brand id (`bn…`) from `brands`.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
Try in playground →
post/boxofficemojo/v1/franchises1 credit

Franchises (Marvel Cinematic Universe, Star Wars, …): total gross, releases, #1 release and its lifetime gross.

ParameterAllowed / rangeDescription
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
Try in playground →
post/boxofficemojo/v1/franchise1 credit

Every film of one franchise with lifetime gross, widest theaters, opening and its theaters, release date and distributor.

ParameterAllowed / rangeDescription
franchise_idrequired—Franchise id (`fr…`) from `franchises`.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
Try in playground →
post/boxofficemojo/v1/genres1 credit

Genre keywords (Adaptation, Adventure, Superhero, Time Travel, …): total gross, number of titles, #1 title and its lifetime gross.

ParameterAllowed / rangeDescription
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
Try in playground →
post/boxofficemojo/v1/genre1 credit

Films of one genre keyword ranked by lifetime gross (100 per page), or its upcoming titles (`view=upcoming`).

ParameterAllowed / rangeDescription
genre_idrequired—Genre keyword id (`sg…`) from `genres`.
areaoptional—Market: a code or name from the `areas` action (`FR`, `France`, `GB`, `JP`, `XWW` = Worldwide, `XNDOM` = International). Default: Domestic (US & Canada). Grosses of every market are printed in US dollars.
view = titlesoptionaltitles · upcomingWhich list.
page = 1optional1–500Page (100 rows per page).
Try in playground →
post/boxofficemojo/v1/showdowns1 credit

Box Office Mojo's head-to-head comparisons (595 measured): name, number of films, combined gross, the leading film and its gross.

Try in playground →
post/boxofficemojo/v1/showdown1 credit

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.

ParameterAllowed / rangeDescription
showdown_idrequired—Showdown id (`sd…`) from `showdowns`.
Try in playground →
post/boxofficemojo/v1/international1 credit

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.

Try in playground →
post/boxofficemojo/v1/areasfree

The market codes this API accepts in `area` (the site's own list: 113 markets plus Domestic, Worldwide and International). No upstream call.

Try in playground →
post/boxofficemojo/v1/calendar1 credit

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.

ParameterAllowed / rangeDescription
dateoptional—Start date YYYY-MM-DD (default: today on the site).
Try in playground →
post/boxofficemojo/v1/schedule_changes1 credit

Recent domestic release-date changes: film, distributor, scale, old date → new date, grouped by the day the change was recorded. 30 rows per page.

ParameterAllowed / rangeDescription
page = 1optional1–200Page (30 rows per page).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.