Developer
DocumentationContact Us
  • Documentation
  • Key Concepts
  • Overview
  • Getting Access to the API
  • API Key Concepts
  • Calling the API
  • Sample Queries
  • Title/Name
  • Box Office
  • Search
  • Overview
  • Bulk Data Key Concepts
  • Data Dictionary
  • Names
  • Titles
  • Box Office
  • Meters
  • Parents Guide
  • Querying In Athena
  • Creating Tables DDL
  • Release Notes

Sample queries: Box Office

Get started with our box office data learning about lifetime grosses, regional results, and weekend returns.

Please note that these are only supported on the Box Office API Product

Example 1

International Opening Gross

IMDb Box Office dataset contains US domestic and international grosses along with the production budget - making it easy to determine which films turned a profit in their worldwide take. To query the opening weekend gross internationally for WALL-E:

    • QUERY
    • RESULT
  • 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 query { # Get WALL·E title(id: "tt0910970") { # Get the international opening weekend gross for WALL·E openingWeekendGross(boxOfficeArea: INTERNATIONAL) { gross { total { amount currency } } # Get the date of the opening weekend end date weekendEndDate } } }

    Result size: 119 bytes

    The response returns $3,159,079 in USD.

    Example 2

    International Opening Gross

    To query for the international lifetime gross for Fight Club:

    • QUERY
    • RESULT
  • 1 2 3 4 5 6 7 8 9 10 11 12 query { # Get Fight Club title(id: "tt0137523") { # Get the lifetime gross for Fight Club in North America lifetimeGross(boxOfficeArea: INTERNATIONAL) { total { amount currency } } } }

    Result size: 74 bytes

    The response returns $64,179,600 in USD.

    Example 3

    Production Budget

    To query for the production budget for Fight Club:

    • QUERY
    • RESULT
  • 1 2 3 4 5 6 7 8 9 10 11 12 query { # Get Fight Club title(id: "tt0137523") { # Get the production budget for Fight Club productionBudget { budget { amount currency } } } }

    Result size: 78 bytes

    The response returns $63,000,000 in USD.

    Example 4

    Ranked Lifetime Gross

    To query the international lifetime gross rank for Titanic:

    • QUERY
    • RESULT
  • 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 query { # Get Titanic title(id: "tt0120338") { rankedLifetimeGross(boxOfficeArea: INTERNATIONAL) { boxOfficeAreaType { code text } rank total { amount currency } } } }

    Result size: 151 bytes

    The response returns that Titanic has an international lifetime gross of $1,590,450,697 in USD and grossed 4th internationally.

    Example 5

    Ranked Lifetime Grosses By Area

    To query the lifetime gross rank for Titanic both worldwide and within Italy:

    • QUERY
    • RESULT
  • 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 query { # Get Titanic title(id: "tt0120338") { rankedLifetimeGrosses( first: 2 filter: { boxOfficeAreaCodes: ["XWW", "IT"] } ) { edges { node { boxOfficeAreaType { code text } rank total { amount currency } } } } } }

    Result size: 283 bytes

    The response returns two items. Globally, Titanic has a lifetime gross of $2,264,743,305 in USD and is ranked 4th. In Italy, Titanic has a lifetime gross of $67,953,353 in USD and is ranked 5th.

    Sample Queries - Search

    Learn the basic functions of searching for titles and names by using our main search within the graph.

    Get started

    Contact us to see how IMDb data can solve your customers needs.

    Contact Us
    • Conditions of Use
    • Privacy Policy

    © 1990-2025 by IMDb.com, Inc.