# 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. - Page: https://fous.com/methods/boxofficemojo.com/get-movie-box-office - Method: `boxofficemojo.com/get_movie_box_office`, version 1 - Website: boxofficemojo.com - Returns: title, release date, distributor, running time, rating, genres, budget, opening weekend, theaters, domestic/international/worldwide gross, markets - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `year` | integer | no | | Release year to distinguish movies with the same title, for example 2024. | | `title` | string | yes | `"Inside Out 2"` | Movie name, for example Inside Out 2. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "title": "Inside Out 2" } ``` Its output: ```json { "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 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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. ## Input schema ```json { "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 ```json { "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" ] } } } ``` ## See more - [Box Office Mojo API: List top grossing movies](https://fous.com/methods/boxofficemojo.com/list-top-grossing-movies.md): Lists the highest-grossing movies of a calendar year, ranked by domestic or worldwide gross, with release dates and distributors. - [Box Office Mojo API: Get daily box office](https://fous.com/methods/boxofficemojo.com/get-daily-box-office.md): Returns the domestic US and Canada daily box office rankings for a date, or the latest reported day when no date is given. - [Box Office Mojo API: Get weekend box office chart](https://fous.com/methods/boxofficemojo.com/get-weekend-box-office.md): Returns 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. - [The Numbers API: Get movie financials](https://fous.com/methods/the-numbers.com/get-movie-financials.md): Looks up a film on The Numbers by title (and optional release year) and returns its budget, box office, physical disc sales and release details. - [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds 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. - [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets 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. - [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets 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. - [Fandango API: Get movie showtimes](https://fous.com/methods/fandango.com/get-movie-showtimes.md): Finds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links. - [All Box Office Mojo methods](https://fous.com/methods/boxofficemojo.com.md)