# Box Office Mojo API: List top grossing movies

> Lists the highest-grossing movies of a calendar year, ranked by domestic or worldwide gross, with release dates and distributors.

Unofficial. Not affiliated with or endorsed by Box Office Mojo.

- Page: https://fous.com/methods/boxofficemojo.com/list-top-grossing-movies
- Method: `boxofficemojo.com/list_top_grossing_movies`, version 1
- Website: boxofficemojo.com
- Returns: rank, title, gross, domestic and international gross, release date, distributor, link
- 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 | `2025` | Calendar year to rank, such as 2025. Defaults to the current year. |
| `scope` | string | no | `"domestic"` | Box office market to rank, such as worldwide. One of "domestic", "worldwide". Default "domestic". |
| `max_results` | integer | no | `5` | Maximum number of ranked movies to return, such as 25. Default 50. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "year": 2025,
  "scope": "domestic",
  "max_results": 5
}
```

Its output:

```json
{
  "movies": [
    {
      "link": "https://www.boxofficemojo.com/release/rl746096129/",
      "rank": 1,
      "gross": 423949195,
      "title": "A Minecraft Movie",
      "currency": "USD",
      "distributor": "Warner Bros.",
      "release_date": "2025-04-04",
      "domestic_gross": null,
      "international_gross": null,
      "widest_release_theaters": 4289
    },
    {
      "link": "https://www.boxofficemojo.com/release/rl3104735233/",
      "rank": 2,
      "gross": 423778855,
      "title": "Lilo & Stitch",
      "currency": "USD",
      "distributor": "Walt Disney Studios Motion Pictures",
      "release_date": "2025-05-23",
      "domestic_gross": null,
      "international_gross": null,
      "widest_release_theaters": 4410
    },
    {
      "link": "https://www.boxofficemojo.com/release/rl1543340801/",
      "rank": 3,
      "gross": 354184465,
      "title": "Superman",
      "currency": "USD",
      "distributor": "Warner Bros.",
      "release_date": "2025-07-11",
      "domestic_gross": null,
      "international_gross": null,
      "widest_release_theaters": 4275
    }
  ]
}
```

## 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/list_top_grossing_movies","input":{"year":2025,"scope":"domestic","max_results":5}}'
```

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 25 highest-grossing movies at the domestic box office in 2019?
- Show me the biggest worldwide box office hits of 2008 ranked by total gross
- Which films earned the most money in US theaters in 2014, with distributors and release dates?
- I need a ranked list of the top 50 worldwide earners from 2022 on boxofficemojo.com
- List the top 10 domestic grossing films from 1995 along with their international earnings

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1900,
      "description": "Calendar year to rank, such as 2025. Defaults to the current year."
    },
    "scope": {
      "enum": [
        "domestic",
        "worldwide"
      ],
      "type": "string",
      "default": "domestic",
      "description": "Box office market to rank, such as worldwide."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of ranked movies to return, such as 25."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "movies"
  ],
  "properties": {
    "movies": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "title",
          "gross",
          "currency",
          "domestic_gross",
          "international_gross",
          "widest_release_theaters",
          "release_date",
          "distributor",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "rank": {
            "type": "integer"
          },
          "gross": {
            "type": [
              "number",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "distributor": {
            "type": [
              "string",
              "null"
            ]
          },
          "release_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "domestic_gross": {
            "type": [
              "number",
              "null"
            ]
          },
          "international_gross": {
            "type": [
              "number",
              "null"
            ]
          },
          "widest_release_theaters": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "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: 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.
- [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.
- [Letterboxd API: List popular films](https://fous.com/methods/letterboxd.com/list-popular-films.md): Lists 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.
- [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.
- [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.
- [Fandango API: List movies now playing or coming soon](https://fous.com/methods/fandango.com/list-now-playing.md): Lists 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.
- [Metacritic API: List best-reviewed titles](https://fous.com/methods/metacritic.com/list-best-reviewed.md): Lists the highest-Metascore games, movies or TV shows on Metacritic for a release year or all time. You can filter by genre, and by platform for games.
- [All Box Office Mojo methods](https://fous.com/methods/boxofficemojo.com.md)