# The Numbers API: Get movie financials

> 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.

Unofficial. Not affiliated with or endorsed by The Numbers.

- Page: https://fous.com/methods/the-numbers.com/get-movie-financials
- Method: `the-numbers.com/get_movie_financials`, version 1
- Website: the-numbers.com
- Returns: title, release year, budget, domestic/international/worldwide box office, opening weekend, DVD and Blu-ray sales, release date, rating, running time, 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 |  | Release year when films have the same title, for example 1954. |
| `title` | string | yes | `"Oppenheimer"` | Movie title, for example Oppenheimer. |

## Output

From a run on Oct 31, 2026. Its input:

```json
{
  "title": "Oppenheimer"
}
```

Its output:

```json
{
  "title": "Oppenheimer",
  "currency": "USD",
  "age_rating": "R",
  "release_year": 2023,
  "running_time": "180 minutes",
  "the_numbers_link": "https://www.the-numbers.com/movie/Oppenheimer-(2023)",
  "production_budget": 100000000,
  "domestic_dvd_sales": 7196529,
  "domestic_box_office": 330078895,
  "worldwide_box_office": 983148052,
  "domestic_release_date": "2023-07-21",
  "domestic_blu_ray_sales": 22831206,
  "domestic_opening_weekend": 82455420,
  "international_box_office": 653069157
}
```

## 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":"the-numbers.com/get_movie_financials","input":{"title":"Oppenheimer"}}'
```

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 production budget and worldwide gross for Barbie (2023)?
- Pull up The Numbers data on Dune: Part Two — opening weekend, domestic and international box office.
- How much did the 1954 Godzilla make at the box office, and what's its running time and rating?
- Find DVD and Blu-ray sales figures for Frozen, along with its release date.
- Check the-numbers.com for Top Gun: Maverick's budget versus its total worldwide earnings.

## Input schema

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release year when films have the same title, for example 1954."
    },
    "title": {
      "type": "string",
      "description": "Movie title, for example Oppenheimer."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "release_year",
    "currency",
    "domestic_release_date",
    "age_rating",
    "running_time",
    "the_numbers_link",
    "production_budget",
    "domestic_box_office",
    "international_box_office",
    "worldwide_box_office",
    "domestic_opening_weekend",
    "domestic_dvd_sales",
    "domestic_blu_ray_sales"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "currency": {
      "enum": [
        "USD"
      ],
      "type": "string"
    },
    "age_rating": {
      "type": [
        "string",
        "null"
      ]
    },
    "release_year": {
      "type": [
        "integer",
        "null"
      ]
    },
    "running_time": {
      "type": [
        "string",
        "null"
      ]
    },
    "the_numbers_link": {
      "type": "string",
      "format": "uri"
    },
    "production_budget": {
      "type": [
        "number",
        "null"
      ],
      "description": "Amount in US dollars; null if unavailable."
    },
    "domestic_dvd_sales": {
      "type": [
        "number",
        "null"
      ],
      "description": "Amount in US dollars; null if unavailable."
    },
    "domestic_box_office": {
      "type": [
        "number",
        "null"
      ],
      "description": "Amount in US dollars; null if unavailable."
    },
    "worldwide_box_office": {
      "type": [
        "number",
        "null"
      ],
      "description": "Amount in US dollars; null if unavailable."
    },
    "domestic_release_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "domestic_blu_ray_sales": {
      "type": [
        "number",
        "null"
      ],
      "description": "Amount in US dollars; null if unavailable."
    },
    "domestic_opening_weekend": {
      "type": [
        "number",
        "null"
      ],
      "description": "Amount in US dollars; null if unavailable."
    },
    "international_box_office": {
      "type": [
        "number",
        "null"
      ],
      "description": "Amount in US dollars; null if unavailable."
    }
  },
  "additionalProperties": false
}
```

## See more

- [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: 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.
- [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.
- [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.
- [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.
- [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.
- [Netflix API: Get movie or show](https://fous.com/methods/netflix.com/get-movie-or-show.md): Gets one Netflix movie or series by its exact name or Netflix title URL: title details, publicly shown seasons and episodes, and whether it is available in a given country's catalogue (checked against public JustWatch listings).
- [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.