Box Office Data Dictionary

Fresh

Box office bulk data is available through the IMDb and Box Office Mojo product subscription. It is organized into four separate datasets, each covering a different aspect of theatrical financial performance.

---

1. boxoffice_title_budgets_v1

Production budget for each title. One record per title that has budget data.

Field	Type	Description
titleId	string	IMDb title ID
budgetItemType	string	Type of budget figure (e.g., "productionBudget")
amount	integer	Budget amount in USD

{
  "titleId": "tt0137523",
  "budgetItemType": "productionBudget",
  "amount": 63000000
}

---

2. boxoffice_title_grosses_v1

Cumulative lifetime gross revenue by territory. One record per title per area.

Field	Type	Description
titleId	string	IMDb title ID
area	string	Territory area code
grossToDate	integer	Cumulative gross to date in USD
rank	integer	All-time rank position within that area

{
  "titleId": "tt0120338",
  "area": "XWW",
  "grossToDate": 1590450697,
  "rank": 4
}

---

3. boxoffice_title_opening_weekends_v1

Opening weekend performance data. One record per title per area.

Field	Type	Description
titleId	string	IMDb title ID
area	string	Territory area code
startDate	string	Opening weekend start date (YYYY-MM-DD)
endDate	string	Opening weekend end date (YYYY-MM-DD)
ocassionId	string	Occasion identifier (e.g., holiday weekends)
gross	integer	Opening weekend gross in USD
numTheaters	integer	Number of theaters in release

{
  "titleId": "tt0910970",
  "area": "XNDOM",
  "startDate": "2008-07-04",
  "endDate": "2008-07-06",
  "ocassionId": "",
  "gross": 3159079,
  "numTheaters": 1215
}

---

4. boxoffice_title_grosses_timeseries_v1

Weekly gross data across the run of a theatrical release. One record per title per area per week.

Field	Type	Description
titleId	string	IMDb title ID
area	string	Territory area code
startDate	string	Week start date (YYYY-MM-DD)
endDate	string	Week end date (YYYY-MM-DD)
ocassionId	string	Occasion identifier if applicable
gross	integer	Gross for this specific week in USD
grossToDate	integer	Cumulative gross through end of this week in USD
numTheaters	integer	Theater count during this week
rank	integer	Weekly box office rank

{
  "titleId": "tt0120338",
  "area": "XDom",
  "startDate": "1997-12-19",
  "endDate": "1997-12-21",
  "ocassionId": "",
  "gross": 28638131,
  "grossToDate": 28638131,
  "numTheaters": 2674,
  "rank": 1
}

---

Area Codes

Rollup Areas

These codes represent aggregated multi-country regions:

Code	Description
XDom	Domestic (United States and Canada)
XWW	Worldwide (all territories)
XNDOM	International (worldwide minus domestic)
APAC	Asia-Pacific
EMEA	Europe, Middle East, and Africa
NA	North America (same as domestic)
LATAM	Latin America

Individual Country Areas

Code	Country	Code	Country
AD	Andorra	MX	Mexico
AE	United Arab Emirates	MY	Malaysia
AR	Argentina	NL	Netherlands
AT	Austria	NO	Norway
AU	Australia	NZ	New Zealand
BE	Belgium	PH	Philippines
BR	Brazil	PL	Poland
CA	Canada	PT	Portugal
CH	Switzerland	RO	Romania
CL	Chile	RU	Russia
CN	China	SA	Saudi Arabia
CO	Colombia	SE	Sweden
CZ	Czech Republic	SG	Singapore
DE	Germany	SK	Slovakia
DK	Denmark	TH	Thailand
EG	Egypt	TR	Turkey
ES	Spain	TW	Taiwan
FI	Finland	UA	Ukraine
FR	France	US	United States
GB	United Kingdom	VE	Venezuela
GR	Greece	VN	Vietnam
HK	Hong Kong	ZA	South Africa
HU	Hungary	HR	Croatia
ID	Indonesia	IL	Israel
IN	India	IQ	Iraq
IT	Italy	IR	Iran
JP	Japan	IS	Iceland
KR	South Korea	LT	Lithuania
KW	Kuwait	LV	Latvia