# Box Office Mojo API: Get weekend box office chart > 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. Unofficial. Not affiliated with or endorsed by Box Office Mojo. - Page: https://fous.com/methods/boxofficemojo.com/get-weekend-box-office - Method: `boxofficemojo.com/get_weekend_box_office`, version 1 - Website: boxofficemojo.com - Returns: ranked releases with weekend gross, change, theaters, averages, total gross, weeks and distributor - 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 | |---|---|---|---|---| | `date` | string | no | `"2025-07-25"` | Any day in the wanted weekend, for example 2025-07-25. Omit for the latest reported weekend. | | `country` | string | no | `"United States"` | Market name, for example United Kingdom. United States means the domestic US and Canada chart. Default "United States". | | `max_results` | integer | no | `10` | Maximum number of ranked releases to return, for example 10. Default 50. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "date": "2025-07-25", "country": "United States", "max_results": 10 } ``` Its output: ```json { "results": [ { "rank": 1, "title": "The Fantastic Four: First Steps", "theaters": 4125, "distributor": "Walt Disney Studios Motion Pictures", "currency_code": "USD", "weekend_gross": 117644828, "weeks_in_release": 1, "last_weekend_rank": null, "average_per_theater": 28519, "total_gross_to_date": 117644828, "box_office_mojo_link": "https://www.boxofficemojo.com/release/rl2429649665/", "change_from_last_weekend_percent": null }, { "rank": 2, "title": "Superman", "theaters": 3930, "distributor": "Warner Bros.", "currency_code": "USD", "weekend_gross": 24851443, "weeks_in_release": 3, "last_weekend_rank": 1, "average_per_theater": 6323, "total_gross_to_date": 289493021, "box_office_mojo_link": "https://www.boxofficemojo.com/release/rl1543340801/", "change_from_last_weekend_percent": -57.5 }, { "rank": 3, "title": "Jurassic World: Rebirth", "theaters": 3550, "distributor": "Universal Pictures", "currency_code": "USD", "weekend_gross": 13201795, "weeks_in_release": 4, "last_weekend_rank": 2, "average_per_theater": 3718, "total_gross_to_date": 301718235, "box_office_mojo_link": "https://www.boxofficemojo.com/release/rl3058794497/", "change_from_last_weekend_percent": -44.3 } ], "weekend_end_date": "2025-07-27", "weekend_start_date": "2025-07-25" } ``` ## 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_weekend_box_office","input":{"date":"2025-07-25","country":"United States","max_results":10}}' ``` 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 were the top 10 movies at the US box office last weekend, with their weekend grosses and theater counts? - Show me the ranked box office chart for the weekend of 2025-07-25 in the United Kingdom. - Which films led the domestic chart the weekend of July 4th 2025, and how much did each earn in total so far? - On boxofficemojo, can you pull the Canada and US weekend rankings for August 8, 2025, including distributors? - Give me the international box office standings for Japan for the most recent weekend, top 20 releases only. ## Input schema ```json { "type": "object", "required": [], "properties": { "date": { "type": "string", "description": "Any day in the wanted weekend, for example 2025-07-25. Omit for the latest reported weekend." }, "country": { "type": "string", "default": "United States", "description": "Market name, for example United Kingdom. United States means the domestic US and Canada chart." }, "max_results": { "type": "integer", "default": 50, "maximum": 100, "minimum": 1, "description": "Maximum number of ranked releases to return, for example 10." } } } ``` ## Output schema ```json { "type": "object", "required": [ "weekend_start_date", "weekend_end_date", "results" ], "properties": { "results": { "type": "array", "items": { "type": "object", "required": [ "rank", "last_weekend_rank", "title", "weekend_gross", "currency_code", "change_from_last_weekend_percent", "theaters", "average_per_theater", "total_gross_to_date", "weeks_in_release", "distributor", "box_office_mojo_link" ], "properties": { "rank": { "type": "integer" }, "title": { "type": "string" }, "theaters": { "type": [ "integer", "null" ] }, "distributor": { "type": [ "string", "null" ] }, "currency_code": { "type": "string" }, "weekend_gross": { "type": [ "number", "null" ] }, "weeks_in_release": { "type": [ "integer", "null" ] }, "last_weekend_rank": { "type": [ "integer", "null" ] }, "average_per_theater": { "type": [ "number", "null" ] }, "total_gross_to_date": { "type": [ "number", "null" ] }, "box_office_mojo_link": { "type": "string" }, "change_from_last_weekend_percent": { "type": [ "number", "null" ] } }, "additionalProperties": false } }, "weekend_end_date": { "type": "string" }, "weekend_start_date": { "type": "string" } }, "additionalProperties": false } ``` ## See more - [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: 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 movie box office](https://fous.com/methods/boxofficemojo.com/get-movie-box-office.md): 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. - [Billboard API: Get chart](https://fous.com/methods/billboard.com/get-chart.md): Gets the ranked entries and chart history for a Billboard chart. It returns the latest published week, or the week that contains a given date. A date between published weeks selects the next published week. - [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles. - [JustWatch API: List streaming chart titles](https://fous.com/methods/justwatch.com/list-streaming-charts.md): Lists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service. - [themoviedb.org API: List upcoming theatrical movies in a country](https://fous.com/methods/themoviedb.org/list-upcoming-movies.md): Lists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score. - [Netflix API: List weekly Top 10](https://fous.com/methods/netflix.com/list-top-10.md): Gets Netflix's weekly Top 10 movies or TV shows worldwide (English or non-English lists, with views, hours viewed and runtime) or in one country (ranks and weeks in the Top 10 only) for the latest published week or the Monday-to-Sunday week containing a given date. - [All Box Office Mojo methods](https://fous.com/methods/boxofficemojo.com.md)