BoxOfficeMojo Builders¶
You can find items using the lists on boxofficemojo.com (BoxOfficeMojo).
No configuration is required for these builders.
mojo_domestic
- Uses the Domestic Box Office.¶
Uses the Domestic Box Office to collection items.
Works With: Movies, Playlists, and Custom Sort
Builder Attribute: mojo_domestic
Builder Value: Dictionary of Attributes
range
- Determines the type of time range of the Box Office
Determines the type of the time range of the Box Office.
Allowed Values: daily
, weekend
, weekly
, monthly
, quarterly
, yearly
, season
, or holiday
year
- Determines the year of the Box Office
Determines the year of the Box Office. This attribute is ignored for the daily
range.
Default Value: current
Allowed Values: Number between 1977 and the current year, current
, or relative current (current-#
; where
#
is the number of year before the current)
range_data
- Determines the actual time range of the Box Office
Determines the actual time range of the Box Office. The input for this value changes depending on the value
of range
.
Warning
This attribute is required for all ranges except the yearly
range.
Daily Allowed Values: Date in the format MM-DD-YYYY
, current
, or relative current (current-#
; where
#
is the number of days before the current)
Weekend Allowed Values: Week Number between 1-53, current
, or relative current (current-#
; where #
is the number of days before the current)
Weekly Allowed Values: Week Number between 1-53, current
, or relative current (current-#
; where #
is the number of days before the current)
Monthly Allowed Values: january
, february
, march
, april
, may
, june
, july
, august
,
september
, october
, november
, december
, current
, or relative current (current-#
; where #
is the
number of days before the current)
Quarterly Allowed Values: q1
, q2
, q3
, q4
, current
, or relative current (current-#
; where #
is the number of days before the current)
Season Allowed Values: winter
, spring
, summer
, fall
, holiday
, or current
Holiday Allowed Values: new_years_day
, new_year_weekend
, mlk_day
, mlk_day_weekend
,
presidents_day
, presidents_day_weekend
, easter
, easter_weekend
, memorial_day
, memorial_day_weekend
,
independence_day
, independence_day_weekend
, labor_day
, labor_day_weekend
, indigenous_day
,
indigenous_day_weekend
, halloween
, thanksgiving
, thanksgiving_3
, thanksgiving_4
, thanksgiving_5
,
post_thanksgiving_weekend
, christmas_day
, christmas_weekend
, or new_years_eve
limit
- The maximum number of result to return
This determines the maximum number of results to return. If there are less results then the limit then all will be returned.
Default Value: Returns all results
Allowed Values: Number greter than 0
mojo_international
- Uses the International Box Office.¶
Uses the International Box Office to collection items.
Works With: Movies, Playlists, and Custom Sort
Builder Attribute: mojo_international
Builder Value: Dictionary of Attributes
range
- Determines the type of time range of the Box Office
Determines the type of the time range of the Box Office.
Allowed Values: weekend
, monthly
, quarterly
, or yearly
chart
- Determines the chart you want to use
Determines the chart you want to use.
Default Value: international
Allowed Values: Item in the drop down found here
year
- Determines the year of the Box Office
Determines the year of the Box Office.
Default Value: current
Allowed Values: Number between 1977 and the current year, current
, or relative current (current-#
; where
#
is the number of year before the current)
range_data
- Determines the actual time range of the Box Office
Determines the actual time range of the Box Office. The input for this value changes depending on the value
of range
.
Warning
This attribute is required for all ranges except the yearly
range.
Weekend Allowed Values: Week Number between 1-53, current
, or relative current (current-#
; where #
is the number of days before the current)
Monthly Allowed Values: january
, february
, march
, april
, may
, june
, july
, august
,
september
, october
, november
, december
, current
, or relative current (current-#
; where #
is the
number of days before the current)
Quarterly Allowed Values: q1
, q2
, q3
, q4
, current
, or relative current (current-#
; where #
is the number of days before the current)
limit
- The maximum number of result to return
This determines the maximum number of results to return. If there are less results then the limit then all will be returned.
Default Value: Returns all results
Allowed Values: Number greter than 0
Example
collections:
Current International Box Office:
mojo_international:
range: yearly
year: current
Last Year's International Box Office:
mojo_international:
range: yearly
year: current-1
Last Months Top 10 German Box Office:
mojo_international:
range: monthly
range_data: current
chart: germany
year: current-1
limit: 10
mojo_world
- Uses the Worldwide Box Office.¶
Uses the Worldwide Box Office to collection items.
Works With: Movies, Playlists, and Custom Sort
Builder Attribute: mojo_world
Builder Value: Dictionary of Attributes
year
- The year of the Worldwide Box Office
This determines the year of the Worldwide Box Office to pull.
Allowed Values: Number between 1977 and the current year, current
, or relative current (current-#
; where
#
is the number of year before the current)
limit
- The maximum number of result to return
This determines the maximum number of results to return. If there are less results then the limit then all will be returned.
Default Value: Returns all results
Allowed Values: Number greter than 0
mojo_all_time
- Uses the All Time Lists.¶
Uses the All Time Lists to collection items.
Works With: Movies, Playlists, and Custom Sort
Builder Attribute: mojo_all_time
Builder Value: Dictionary of Attributes
chart
- Determines the chart you want to use
Determines the chart you want to use.
Allowed Values: domestic
or worldwide
content_rating_filter
- Determines the content rating chart to use
Determines the content rating chart to use.
Allowed Values: g
, g/pg
, pg
, pg-13
, r
or nc-17
limit
- The maximum number of result to return
This determines the maximum number of results to return. If there are less results then the limit then all will be returned.
Default Value: Returns all results
Allowed Values: Number greter than 0
mojo_never
- Uses the Never Hit Lists.¶
Uses the Never Hit Lists (Bottom Section) to
collection items.
Works With: Movies, Playlists, and Custom Sort
Builder Attribute: mojo_never
Builder Value: Dictionary of Attributes
chart
- Determines the chart you want to use
Determines the chart you want to use.
Allowed Values: Item in the drop down found here
never
- Determines the never filter to use
Determines the never filter to use.
Default Value: 1
Allowed Values: 1
, 5
, or 10
limit
- The maximum number of result to return
This determines the maximum number of results to return. If there are less results then the limit then all will be returned.
Default Value: Returns all results
Allowed Values: Number greter than 0
mojo_record
- Uses other Record Lists.¶
Uses the Weekend Records,
Daily Records, and
Miscellaneous Records to collection items.
Works With: Movies, Playlists, and Custom Sort
Builder Attribute: mojo_record
Builder Value: Dictionary of Attributes
chart
- Determines the record you want to use
Determines the chart you want to use.
Allowed Values: second_weekend_drop
, post_thanksgiving_weekend_drop
, top_opening_weekend
,
worst_opening_weekend_theater_avg
, mlk_opening
, easter_opening
, memorial_opening
, labor_opening
,
president_opening
, thanksgiving_3_opening
, thanksgiving_5_opening
, mlk
, easter
, 4th
, memorial
,
labor
, president
, thanksgiving_3
, thanksgiving_5
, january
, february
, march
, april
, may
,
june
, july
, august
, september
, october
, november
, december
, spring
, summer
, fall
,
holiday_season
, winter
, g
, g/pg
, pg
, pg-13
, r
, nc-17
, top_opening_weekend_theater_avg_all
,
top_opening_weekend_theater_avg_wide
, opening_day
, single_day_grosses
, christmas_day_gross
,
new_years_day_gross
, friday
, saturday
, sunday
, monday
, tuesday
, wednesday
, thursday
,
friday_non_opening
, saturday_non_opening
, sunday_non_opening
, monday_non_opening
, tuesday_non_opening
,
wednesday_non_opening
, thursday_non_opening
, biggest_theater_drop
, or opening_week
limit
- The maximum number of result to return
This determines the maximum number of results to return. If there are less results then the limit then all will be returned.
Default Value: Returns all results
Allowed Values: Number greter than 0