Skip to content

Box Office Queries

Fresh

Box office data requires the IMDb and Box Office Mojo product subscription. These queries return financial performance data including opening weekend grosses, lifetime grosses, budgets, and ranked figures by territory.


1. International Opening Gross

Retrieve the international opening weekend gross for WALL-E.

graphql
{
  title(id: "tt0910970") {
    titleText { text }
    openingWeekendGross(boxOfficeArea: XNDOM) {
      gross {
        total {
          amount
          currency
        }
      }
      weekendEndDate
    }
  }
}

Response:

json
{
  "data": {
    "title": {
      "titleText": { "text": "WALL-E" },
      "openingWeekendGross": {
        "gross": {
          "total": {
            "amount": 3159079,
            "currency": "USD"
          }
        },
        "weekendEndDate": "2008-07-06"
      }
    }
  }
}

International opening weekend gross: $3,159,079


2. International Lifetime Gross

Retrieve the total international (non-domestic) lifetime gross for Fight Club.

graphql
{
  title(id: "tt0137523") {
    titleText { text }
    lifetimeGross(boxOfficeArea: XNDOM) {
      gross {
        total {
          amount
          currency
        }
      }
    }
  }
}

Response:

json
{
  "data": {
    "title": {
      "titleText": { "text": "Fight Club" },
      "lifetimeGross": {
        "gross": {
          "total": {
            "amount": 64179600,
            "currency": "USD"
          }
        }
      }
    }
  }
}

International lifetime gross: $64,179,600


3. Production Budget

Retrieve the production budget for Fight Club.

graphql
{
  title(id: "tt0137523") {
    titleText { text }
    productionBudget {
      budget {
        amount
        currency
      }
    }
  }
}

Response:

json
{
  "data": {
    "title": {
      "titleText": { "text": "Fight Club" },
      "productionBudget": {
        "budget": {
          "amount": 63000000,
          "currency": "USD"
        }
      }
    }
  }
}

Production budget: $63,000,000


4. Ranked Lifetime Gross

Retrieve the worldwide lifetime gross for Titanic including its all-time rank position.

graphql
{
  title(id: "tt0120338") {
    titleText { text }
    rankedLifetimeGross(boxOfficeArea: XWW) {
      gross {
        total {
          amount
          currency
        }
      }
      rank
    }
  }
}

Response:

json
{
  "data": {
    "title": {
      "titleText": { "text": "Titanic" },
      "rankedLifetimeGross": {
        "gross": {
          "total": {
            "amount": 1590450697,
            "currency": "USD"
          }
        },
        "rank": 4
      }
    }
  }
}

Worldwide lifetime gross: $1,590,450,697 — ranked 4th all time.


5. Ranked Lifetime Grosses by Multiple Areas

Use GraphQL aliases to retrieve ranked lifetime grosses for multiple territories in a single request.

graphql
{
  title(id: "tt0120338") {
    titleText { text }

    worldwide: rankedLifetimeGross(boxOfficeArea: XWW) {
      gross {
        total {
          amount
          currency
        }
      }
      rank
    }

    italy: rankedLifetimeGross(boxOfficeArea: IT) {
      gross {
        total {
          amount
          currency
        }
      }
      rank
    }
  }
}

Response:

json
{
  "data": {
    "title": {
      "titleText": { "text": "Titanic" },
      "worldwide": {
        "gross": {
          "total": {
            "amount": 1590450697,
            "currency": "USD"
          }
        },
        "rank": 4
      },
      "italy": {
        "gross": {
          "total": {
            "amount": 22100000,
            "currency": "USD"
          }
        },
        "rank": 12
      }
    }
  }
}

This pattern works with any valid area code. See the Box Office Data Dictionary for the full list of area abbreviations.

Common Area Codes

CodeDescription
XWWWorldwide (all territories combined)
XDomDomestic (United States and Canada)
XNDOMInternational (worldwide minus domestic)
USUnited States only
GBUnited Kingdom
DEGermany
FRFrance
JPJapan
AUAustralia
ITItaly

IMDb API Documentation — Internal Reference