Box Office Mojo API: Get movie box office
Finds a movie on Box Office Mojo by title, with an optional year, and returns its box office totals, release details, theater counts and markets.
Unofficial. Not affiliated with or endorsed by Box Office Mojo.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Year optional
year Release year to distinguish movies with the same title, for example 2024.
Not set
Whole number.
- Title, required
title Movie name, for example Inside Out 2.
Inside Out 2
Input as JSON
{ "title": "Inside Out 2"}Output
{ "title": "Inside Out 2", "budget": { "amount": 200000000, "currency": "USD" }, "genres": [ "Adventure", "·", "Animation" ], "markets": [ { "country": "United States and Canada", "total_gross": { "amount": 652980194, "currency": "USD" }, "release_date": "2024-06-14", "opening_weekend_gross": { "amount": 154201673, "currency": "USD" } }, { "country": "Mexico", "total_gross": { "amount": 102299578, "currency": "USD" }, "release_date": "2024-06-13", "opening_weekend_gross": { "amount": 29855385, "currency": "USD" } }, { "country": "Brazil", "total_gross": { "amount": 80685542, "currency": "USD" }, "release_date": "2024-06-20", "opening_weekend_gross": { "amount": 17604728, "currency": "USD" } } ], "age_rating": "PG", "distributor": "Walt Disney Studios Motion Pictures", "release_date": "2024-06-14", "running_time": "1 hr 36 min", "imdb_title_id": "tt22022452", "domestic_gross": { "amount": 652980194, "currency": "USD" }, "worldwide_gross": { "amount": 1698863816, "currency": "USD" }, "opening_theaters": 4440, "international_gross": { "amount": 1045883622, "currency": "USD" }, "box_office_mojo_link": "https://www.boxofficemojo.com/title/tt22022452/" , "opening_weekend_gross": { "amount": 154201673, "currency": "USD" }, "widest_release_theaters": 4440}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"boxofficemojo.com/get_movie_box_office","input":{"title":"Inside Out 2"}}' # 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_movie_box_office" , "input": { "title": "Inside Out 2" }})# 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_movie_box_office" , "input": { "title": "Inside Out 2" } }), 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_movie_box_office# with {"title":"Inside Out 2"}"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": [ "title" ], "properties": { "year": { "type": "integer", "description": "Release year to distinguish movies with the same title, for example 2024." }, "title": { "type": "string", "minLength": 1, "description": "Movie name, for example Inside Out 2." } }}Output schema
{ "type": "object", "required": [ "title", "genres", "box_office_mojo_link", "markets", "imdb_title_id" ], "properties": { "title": { "type": "string" }, "budget": { "type": [ "object", "null" ] }, "genres": { "type": "array", "items": { "type": "string" } }, "markets": { "type": "array", "items": { "type": "object", "properties": { "country": { "type": "string" }, "total_gross": { "type": [ "object", "null" ] }, "release_date": { "type": [ "string", "null" ] }, "opening_weekend_gross": { "type": [ "object", "null" ] } } } }, "age_rating": { "type": [ "string", "null" ] }, "distributor": { "type": [ "string", "null" ] }, "release_date": { "type": [ "string", "null" ] }, "running_time": { "type": [ "string", "null" ] }, "imdb_title_id": { "type": "string" }, "domestic_gross": { "type": [ "object", "null" ] }, "worldwide_gross": { "type": [ "object", "null" ] }, "opening_theaters": { "type": [ "integer", "null" ] }, "international_gross": { "type": [ "object", "null" ] }, "box_office_mojo_link": { "type": "string" }, "opening_weekend_gross": { "type": [ "object", "null" ] }, "widest_release_theaters": { "type": [ "integer", "null" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
boxofficemojo.com/get_movie_box_office- Returns
- title, release date, distributor, running time, rating, genres, budget, opening weekend, theaters, domestic/international/worldwide gross, markets
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_movie_box_office with the inputs above.
Ask your agent
- What was the worldwide gross and opening weekend for Inside Out 2 (2024)?
- How many theaters did Oppenheimer open in, and what was its domestic total?
- Find the budget, running time, and distributor of the 2023 film Barbie.
- Box office totals for Dune Part Two released in 2024, including international gross.
- On boxofficemojo.com, look up the 2019 movie Joker and show its rating, genres, and release date.
See more
All Box Office Mojo methodsLists the highest-grossing movies of a calendar year, ranked by domestic or worldwide gross, with release dates and distributors.
boxofficemojo.com/list_top_grossing_moviesReturns the domestic US and Canada daily box office rankings for a date, or the latest reported day when no date is given.
boxofficemojo.com/get_daily_box_officeReturns 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_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 on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country.
themoviedb.org/get_movieGets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series.
rottentomatoes.com/get_scoresGets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null.
imdb.com/get_movie_or_showFinds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links.
fandango.com/get_movie_showtimes