# Box Office Mojo API — daily, weekend, weekly, yearly and all-time box office charts, film grosses by market, international box office, franchises, brands, genres, release calendar

> 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.
> ReefAPI engine `boxofficemojo` · 29 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/boxofficemojo/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/boxofficemojo/v1/search — 1 credit
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.

**Parameters:**
- `query` (string, required) — Film title words, e.g. `avatar`, `minecraft`.

**Returns:** results[]{position, title_id, title, year, genres[], cast[], poster_url, url} + count + query

**Example request body:**
```json
{
  "query": "avatar"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/title — 1 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`.

**Parameters:**
- `title_id` (string, required) — IMDb title id (`tt…`) or a boxofficemojo.com / imdb.com title URL. From `search`, chart rows (`title_id`) or IMDb.

**Returns:** title{title_id, title, year, description, poster_url, summary{domestic_usd, domestic_pct, international_usd, international_pct, worldwide_usd, domestic_distributor, domestic_distributor_id, domestic_opening_usd, budget_usd, earliest_release_date, earliest_release_regions[], mpa_rating, running_time, running_time_minutes, genres[]}, release_groups[]{name, release_group_id, rollout, areas, domestic_usd, international_usd, worldwide_usd}, markets[]{region, area, releases, lifetime_gross_usd, rank}, releases[]{region, area, release_id, release_date, opening_usd, gross_usd} (single-group films), brands[], franchises[], genre_keywords[]}

**Example request body:**
```json
{
  "title_id": "tt1630029"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/title_credits — 1 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.

**Parameters:**
- `title_id` (string, required) — IMDb title id (`tt…`) or a boxofficemojo.com / imdb.com title URL. From `search`, chart rows (`title_id`) or IMDb.

**Returns:** title{title_id, title, year} + crew[]{role, name, person_id} + cast[]{character, name, person_id}

**Example request body:**
```json
{
  "title_id": "tt1630029"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/release_group — 1 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).

**Parameters:**
- `release_group_id` (string, required) — Release group id (`gr…`) or its URL: from `title` (`release_groups[]`), `worldwide_year_chart` rows or `release.release_group_id`.

**Returns:** release_group{release_group_id, title_id, title, description, summary{domestic_usd, domestic_pct, international_usd, international_pct, worldwide_usd, …}, releases[]{region, area, release_id, release_date, release_date_text, opening_usd, gross_usd}, title_groups[]}

**Example request body:**
```json
{
  "release_group_id": "gr2845135365"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/release — 1 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.

**Parameters:**
- `release_id` (string, required) — 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` (enum, optional, default "daily") — Which run table to return. [one of: daily, weekend, weekly]

**Returns:** release{release_id, title, title_id, area, release_group_id, release_group, description, summary{…_usd, distributor, distributor_id, opening_usd, opening_theaters, release_date, release_date_end, wide_release_date, mpa_rating, running_time_minutes, genres[], widest_release_theaters, budget_usd}, area_releases[]{area, release_id}, views[]} + view + columns[] + rows[] (daily: date, rank, gross_usd, gross_change_day_pct, gross_change_week_pct, theaters, per_theater_average_gross_usd, gross_to_date_usd, day_in_release, estimated; weekend/weekly: dates, weekend_id/week_id, …) + count

**Example request body:**
```json
{
  "release_id": "rl2417000449"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/rankings — 1 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`.

**Parameters:**
- `title_id` (string, optional) — IMDb title id: all releases of the film.
- `release_id` (string, optional) — Release id: one market's release.

**Returns:** title{title, title_id} + rankings[]{section, chart, chart_slug, chart_variant, rank} + count

**Example request body:**
```json
{
  "title_id": "tt1630029"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/daily_chart — 1 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).

**Parameters:**
- `date` (string, required) — Day, YYYY-MM-DD.

**Returns:** rows[]{rank, rank_yesterday, title, release_id, gross_usd, gross_change_day_pct, gross_change_week_pct, theaters, per_theater_average_gross_usd, gross_to_date_usd, days_in_release, distributor, distributor_id, new_this_day, estimated} + columns[] + count + heading + data_as_of

**Example request body:**
```json
{
  "date": "2025-11-08"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/weekend_chart — 1 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.

**Parameters:**
- `weekend` (string, required) — Weekend id like `2025W45` (year + W + the site's weekend number); `year_breakdown` with breakdown=weekends lists every weekend_id.
- `area` (string, optional) — 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` (enum, optional, default "chart") — Which table. [one of: chart, estimates, by_distributor]

**Returns:** rows[] (chart: rank, rank_last_week, title, release_id, gross_usd, gross_change_week_pct, theaters, theaters_change, per_theater_average_gross_usd, gross_to_date_usd, weeks_in_release, distributor, new_this_week, estimated) + columns[] + count + heading + subheading (dates) + data_as_of + view

**Example request body:**
```json
{
  "weekend": "2025W45"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/weekly_chart — 1 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).

**Parameters:**
- `week` (string, required) — Week id like `2025W45`; `year_breakdown` with breakdown=weeks lists every week_id.
- `view` (enum, optional, default "chart") — Which table. [one of: chart, weekend_vs_weekdays, by_distributor]

**Returns:** rows[] + columns[] + count + heading + data_as_of + view

**Example request body:**
```json
{
  "week": "2025W45"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/year_chart — 1 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.

**Parameters:**
- `year` (integer, required) — Calendar year (Domestic data from 1977).
- `area` (string, optional) — 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` (enum, optional, default "calendar") — Which gross the chart ranks by. [one of: calendar, total]
- `sort` (enum, optional, default "rank") — Column the site sorts by. [one of: rank, gross, theaters, total_gross, release_date]
- `sort_dir` (enum, optional, default "desc") — Sort direction. [one of: desc, asc]

**Returns:** rows[]{rank, title, release_id, gross_usd, max_theaters, total_gross_usd, release_date, release_date_text, distributor, distributor_id, genre, budget_usd, running_time, estimated} + columns[] + count + heading + data_as_of

**Example request body:**
```json
{
  "year": 2025
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/period_chart — 1 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.

**Parameters:**
- `period_type` (enum, optional, default "month") — Kind of period. [one of: month, quarter, season, holiday]
- `period` (string, required) — 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`).
- `year` (integer, required) — Year.
- `area` (string, optional) — 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` (enum, optional, default "calendar") — Which gross the chart ranks by. [one of: calendar, total]

**Returns:** rows[] + columns[] + count + heading + data_as_of

### POST https://api.reefapi.com/boxofficemojo/v1/worldwide_year_chart — 1 credit
Top films worldwide for a year (release groups): worldwide, domestic and international gross with each share. 200 rows (the site's ceiling).

**Parameters:**
- `year` (integer, required) — Year.

**Returns:** rows[]{rank, title, release_group_id, worldwide_usd, domestic_usd, domestic_pct, international_usd, international_pct} + columns[] + count + heading + data_as_of

**Example request body:**
```json
{
  "year": 2025
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/yearly_totals — 1 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`).

**Parameters:**
- `view` (enum, optional, default "totals") — Which table. [one of: totals, year_to_date, openings]
- `area` (string, optional) — 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` (enum, optional, default "calendar") — Which gross the chart ranks by. [one of: calendar, total]
- `through_month` (string, optional) — year_to_date only: cumulative through this month (`january` … `december`) instead of through today.

**Returns:** rows[] + columns[] + count + heading + data_as_of

**Example request body:**
```json
{
  "area": "FR"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/year_breakdown — 1 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` …).

**Parameters:**
- `year` (integer, required) — Year.
- `breakdown` (enum, optional, default "weekends") — Unit of the split. [one of: days, weekends, weeks, months, quarters, seasons, holidays]
- `area` (string, optional) — 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` (enum, optional, default "calendar") — Which gross the chart ranks by. [one of: calendar, total]
- `daily_view` (enum, optional, default "year") — days only: the site's day-list grouping. [one of: year, season, quarter, month, holiday, cumulative]

**Returns:** rows[] + columns[] + count + heading + data_as_of

### POST https://api.reefapi.com/boxofficemojo/v1/weekend_across_years — 1 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.

**Parameters:**
- `weekend_number` (integer, required) — Weekend number 1-53.
- `area` (string, optional) — 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. 

**Returns:** rows[]{year, weekend, weekend_id, top_10_gross_usd, …, top_release, top_release_id} + columns[] + count

**Example request body:**
```json
{
  "weekend_number": 47
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/all_time_chart — 1 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.

**Parameters:**
- `chart` (enum, required) — Chart slug (from `all_time_records` or `rankings`). [one of: top_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_theaters]
- `variant` (string, optional) — 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.
- `area` (string, optional) — 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` (integer, optional, default 1) — Page of the chart (the site serves 200 rows per page).

**Returns:** rows[] (chart's own columns: rank, title, title_id/release_id, money in *_usd, …) + columns[] + count + page + has_more + page_label + heading

**Example request body:**
```json
{
  "chart": "top_lifetime_gross"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/all_time_records — 1 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`.

**Parameters:**
- `section` (enum, optional, default "overall") — Index page. [one of: overall, weekend, daily, misc]
- `area` (string, optional) — 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. 

**Returns:** rows[]{group, chart, chart_slug, chart_variant, title, release_id/title_id, record, record_value} + count

**Example request body:**
```json
{
  "area": "FR"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/brands — 1 credit
Brands (Marvel Comics, Pixar, DC Comics, …): total gross, number of releases, #1 release and its lifetime gross.

**Parameters:**
- `area` (string, optional) — 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. 

**Returns:** rows[]{brand, brand_id, total_usd, releases, top_release, top_release_id, lifetime_gross_usd} + count

**Example request body:**
```json
{
  "area": "FR"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/brand — 1 credit
Every film of one brand: rank, lifetime gross, widest theaters, opening weekend and theaters, release date, distributor.

**Parameters:**
- `brand_id` (string, required) — Brand id (`bn…`) from `brands`.
- `area` (string, optional) — 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. 

**Returns:** rows[]{rank, title, release_id, lifetime_gross_usd, max_theaters, opening_usd, opening_theaters, release_date, distributor, distributor_id, estimated} + count + heading

**Example request body:**
```json
{
  "brand_id": "bn3732077058"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/franchises — 1 credit
Franchises (Marvel Cinematic Universe, Star Wars, …): total gross, releases, #1 release and its lifetime gross.

**Parameters:**
- `area` (string, optional) — 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. 

**Returns:** rows[]{franchise, franchise_id, total_usd, releases, top_release, top_release_id, lifetime_gross_usd} + count

**Example request body:**
```json
{
  "area": "FR"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/franchise — 1 credit
Every film of one franchise with lifetime gross, widest theaters, opening and its theaters, release date and distributor.

**Parameters:**
- `franchise_id` (string, required) — Franchise id (`fr…`) from `franchises`.
- `area` (string, optional) — 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. 

**Returns:** rows[] (same as brand) + count + heading

**Example request body:**
```json
{
  "franchise_id": "fr541495045"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/genres — 1 credit
Genre keywords (Adaptation, Adventure, Superhero, Time Travel, …): total gross, number of titles, #1 title and its lifetime gross.

**Parameters:**
- `area` (string, optional) — 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. 

**Returns:** rows[]{genre, genre_id, total_usd, titles, top_title, top_title_id, lifetime_gross_usd} + count

**Example request body:**
```json
{
  "area": "FR"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/genre — 1 credit
Films of one genre keyword ranked by lifetime gross (100 per page), or its upcoming titles (`view=upcoming`).

**Parameters:**
- `genre_id` (string, required) — Genre keyword id (`sg…`) from `genres`.
- `area` (string, optional) — 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` (enum, optional, default "titles") — Which list. [one of: titles, upcoming]
- `page` (integer, optional, default 1) — Page (100 rows per page).

**Returns:** rows[]{rank, title, title_id, lifetime_gross_usd, max_theaters, opening_usd, opening_theaters, release_date, distributor} + count + page + has_more + heading

**Example request body:**
```json
{
  "genre_id": "sg2380263681"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/showdowns — 1 credit
Box Office Mojo's head-to-head comparisons (595 measured): name, number of films, combined gross, the leading film and its gross.

**Parameters:** none

**Returns:** rows[]{showdown, showdown_id, num_releases, total_gross_usd, top_release, top_release_id, top_release_gross_usd} + count

### POST https://api.reefapi.com/boxofficemojo/v1/showdown — 1 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.

**Parameters:**
- `showdown_id` (string, required) — Showdown id (`sd…`) from `showdowns`.

**Returns:** showdown{title, releases[]{title, release_id, summary{…}}}

**Example request body:**
```json
{
  "showdown_id": "sd943519236"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/international — 1 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.

**Parameters:** none

**Returns:** rows[]{group, area, area_code, weekend, weekend_id, releases, top_release, top_release_id, distributor, weekend_gross_usd} + count

### POST https://api.reefapi.com/boxofficemojo/v1/areas — 0 credits
The market codes this API accepts in `area` (the site's own list: 113 markets plus Domestic, Worldwide and International). No upstream call.

**Parameters:** none

**Returns:** areas[]{code, name} + count

### POST https://api.reefapi.com/boxofficemojo/v1/calendar — 1 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.

**Parameters:**
- `date` (string, optional) — Start date YYYY-MM-DD (default: today on the site).

**Returns:** rows[]{group (release date), release_date, title, release_id, title_id, genres[], cast[], running_time, poster_url, distributor, distributor_id, scale} + count

**Example request body:**
```json
{
  "date": "2026-12-01"
}
```

### POST https://api.reefapi.com/boxofficemojo/v1/schedule_changes — 1 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.

**Parameters:**
- `page` (integer, optional, default 1) — Page (30 rows per page).

**Returns:** rows[]{group (change recorded), title, release_id, distributor, scale, old_date, new_date} + count + page + has_more

**Example request body:**
```json
{
  "page": 2
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=boxofficemojo
- Human docs page: https://reefapi.com/docs/boxofficemojo
- Overview page: https://reefapi.com/boxofficemojo-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
