Box Office Mojo API: Get daily box office
Returns the domestic US and Canada daily box office rankings for a date, or the latest reported day when no date is given.
Unofficial. Not affiliated with or endorsed by Box Office Mojo.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Date optional
date Domestic box office date, such as 2025-06-13. Leave blank for the latest reported day.
Not set
Date.
- Max Results optional
max_results Maximum ranked movies to return, such as 20 (default 50, maximum 100).
50 (default)
Whole number from 1 to 100.
Input as JSON
{}Output
{ "date": "2026-10-21", "results": [ { "rank": 1, "title": "You Can See Everything", "theaters": 855, "distributor": "A24", "currency_code": "USD", "daily_gross_usd": 2602315, "days_in_release": 6, "previous_day_rank": 2, "box_office_mojo_link": "https://www.boxofficemojo.com/release/rl3025109249/" , "average_per_theater_usd": 3043, "total_gross_to_date_usd": 23407485, "change_from_previous_day_percent": -1, "change_from_same_day_last_week_percent": null }, { "rank": 2, "title": "Street Fighter", "theaters": 3575, "distributor": "Paramount Pictures", "currency_code": "USD", "daily_gross_usd": 1646591, "days_in_release": 6, "previous_day_rank": 1, "box_office_mojo_link": "https://www.boxofficemojo.com/release/rl1752465409/" , "average_per_theater_usd": 460, "total_gross_to_date_usd": 37177832, "change_from_previous_day_percent": -42.5, "change_from_same_day_last_week_percent": null }, { "rank": 3, "title": "Other Mommy", "theaters": 3370, "distributor": "Universal Pictures", "currency_code": "USD", "daily_gross_usd": 703535, "days_in_release": 13, "previous_day_rank": 5, "box_office_mojo_link": "https://www.boxofficemojo.com/release/rl1875148801/" , "average_per_theater_usd": 208, "total_gross_to_date_usd": 47127905, "change_from_previous_day_percent": -30.3, "change_from_same_day_last_week_percent": -57.4 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"boxofficemojo.com/get_daily_box_office","input":{}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "boxofficemojo.com/get_daily_box_office" , "input": {}})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "boxofficemojo.com/get_daily_box_office" , "input": {} }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run boxofficemojo.com/get_daily_box_office# with {}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [], "properties": { "date": { "type": "string", "format": "date", "description": "Domestic box office date, such as 2025-06-13. Leave blank for the latest reported day." }, "max_results": { "type": "integer", "default": 50, "maximum": 100, "minimum": 1, "description": "Maximum ranked movies to return, such as 20 (default 50, maximum 100)." } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "date", "results" ], "properties": { "date": { "type": "string", "format": "date", "description": "Reported box office date." }, "results": { "type": "array", "items": { "type": "object", "required": [ "rank", "previous_day_rank", "title", "daily_gross_usd", "currency_code", "change_from_previous_day_percent", "change_from_same_day_last_week_percent", "theaters", "average_per_theater_usd", "total_gross_to_date_usd", "days_in_release", "distributor", "box_office_mojo_link" ], "properties": { "rank": { "type": "integer", "description": "Rank for the day." }, "title": { "type": "string", "description": "Movie release title." }, "theaters": { "type": [ "integer", "null" ], "description": "Number of theaters, if available." }, "distributor": { "type": [ "string", "null" ], "description": "Distributor, if listed." }, "currency_code": { "type": "string", "description": "Currency of all monetary amounts (USD)." }, "daily_gross_usd": { "type": [ "number", "null" ], "description": "Gross earned on this date in US dollars." }, "days_in_release": { "type": [ "integer", "null" ], "description": "Days since release, if available." }, "previous_day_rank": { "type": [ "integer", "null" ], "description": "Rank on the preceding day, or null for a new release." }, "box_office_mojo_link": { "type": "string", "description": "Box Office Mojo page for this release." }, "average_per_theater_usd": { "type": [ "number", "null" ], "description": "Daily gross per theater in US dollars, if available." }, "total_gross_to_date_usd": { "type": [ "number", "null" ], "description": "Total domestic gross to date in US dollars, if available." }, "change_from_previous_day_percent": { "type": [ "number", "null" ], "description": "Percentage change from the previous day; null if unavailable." }, "change_from_same_day_last_week_percent": { "type": [ "number", "null" ], "description": "Percentage change from the same day last week; null if unavailable." } }, "additionalProperties": false }, "description": "Daily releases in rank order." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
boxofficemojo.com/get_daily_box_office- Returns
- date, rank, title, daily gross, theaters, distributor, Box Office Mojo link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method boxofficemojo.com/get_daily_box_office with the inputs above.
Ask your agent
- What were the top grossing movies at the US box office yesterday?
- Show me the domestic daily box office rankings for 2025-06-13 with gross and theater counts.
- I need the latest reported daily box office chart for the US and Canada, top 20 films only.
- Which distributor released the number one movie on boxofficemojo.com for the most recent day?
- Give me the daily domestic ranking for March 8, 2025, including each film's gross and number of theaters.
See more
All Box Office Mojo methodsReturns ranked box office grosses for a weekend in a market. Defaults to the latest reported US and Canada weekend; international markets use their own weekend calendar.
boxofficemojo.com/get_weekend_box_officeLists the highest-grossing movies of a calendar year, ranked by domestic or worldwide gross, with release dates and distributors.
boxofficemojo.com/list_top_grossing_moviesFinds a movie on Box Office Mojo by title, with an optional year, and returns its box office totals, release details, theater counts and markets.
boxofficemojo.com/get_movie_box_officeLooks up a film on The Numbers by title (and optional release year) and returns its budget, box office, physical disc sales and release details.
the-numbers.com/get_movie_financialsFinds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links.
fandango.com/get_movie_showtimesLists Letterboxd films in popularity order for a week, month, year or all time, optionally filtered by genre and decade. Ratings and posters may be unavailable for some films.
letterboxd.com/list_popular_filmsGets a movie theater's films and showtimes on Fandango for a date, from the theater's name and its city or ZIP code. Each film lists its rating, runtime and showtimes grouped by format with ticket links; a date without listed showtimes returns no films.
fandango.com/get_theater_showtimesLists Fandango movies now playing or coming soon in U.S. theaters, in Fandango's order, with release dates, age ratings, runtimes and Rotten Tomatoes scores when shown.
fandango.com/list_now_playing