Skip to content

BoxOfficeMojo Builders

You can find items using the lists on boxofficemojo.com (BoxOfficeMojo).

Builder Description Works with Movies Works with Shows Works with Playlists and Custom Sort
mojo_domestic Uses the Domestic Box Office.
mojo_international Uses the International Box Office.
mojo_world Uses the Worldwide Box Office.
mojo_all_time Uses the All Time lists.
mojo_never Uses the Never Hit lists.
mojo_record Uses other Record lists.

Uses the Domestic Box Office to collect items.

Builder Attribute: mojo_domestic

Builder Value: Dictionary of Attributes

Attribute Description
range Determines the type of 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. 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-#)
range_data Determines the actual time range of the Box Office. The input changes depending on the value of range.
Required: Yes, except for yearly range
limit The maximum number of results to return.
Default Value: Returns all results
Allowed Values: Number greater than 0
Range Allowed Values
daily Date in the format MM-DD-YYYY, current, or relative (current-#) where # is days before current
weekend Week number (1–53), current, or relative (current-#) where # is days before current
weekly Week number (1–53), current, or relative (current-#) where # is days before current
monthly january, february, ..., december, current, or relative (current-#) where # is days before current
quarterly q1, q2, q3, q4, current, or relative (current-#) where # is days before current
season winter, spring, summer, fall, holiday, or current
holiday 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, new_years_eve

Example Mojo Domestic Builder(s)

collections:
  Current Domestic Box Office:
    mojo_domestic:
      range: yearly
      year: current

  Last Year's Domestic Box Office:
    mojo_domestic:
      range: yearly
      year: current-1

  Last Month's Top 10 Domestic Box Office:
    mojo_domestic:
      range: monthly
      range_data: current
      year: current-1
      limit: 10

Uses the International Box Office to collect items.

Builder Attribute: mojo_international

Builder Value: Dictionary of Attributes

Attribute Description
range Determines the type of time range of the Box Office.
Allowed Values: weekend, monthly, quarterly, or yearly
chart Determines the chart you want to use.
Default Value: international
Allowed Values: Item in the dropdown found here
year Determines the year of the Box Office.
Default Value: current
Allowed Values: Number between 1977 and the current year, current, or relative current (current-#)
range_data Determines the actual time range of the Box Office. Required for all ranges except yearly. Input depends on the range selected.
limit The maximum number of results to return.
Default Value: Returns all results
Allowed Values: Number greater than 0
Range Allowed Values
weekend Week number (1–53), current, or relative (current-#) where # is days before current
monthly january, february, ..., december, current, or relative (current-#) where # is days before current
quarterly q1, q2, q3, q4, current, or relative (current-#) where # is days before current

Example Mojo International Builder(s)

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 Month's Top 10 German Box Office:
    mojo_international:
      range: monthly
      range_data: current
      chart: germany
      year: current-1
      limit: 10

Uses the Worldwide Box Office to collect items.

Builder Attribute: mojo_world

Builder Value: Dictionary of Attributes

Attribute Description
year The year of the Worldwide Box Office to pull.
Allowed Values: Number between 1977 and the current year, current, or relative current (current-#)
limit The maximum number of results to return.
Default Value: Returns all results
Allowed Values: Number greater than 0

Example Mojo Worldwide Builder(s)

collections:

  Current Worldwide Box Office:
    mojo_world:
      year: current

  Last Year's Worldwide Box Office:
    mojo_world:
      year: current-1

  2020 Top 10 Worldwide Box Office:
    mojo_world:
      year: 2020
      limit: 10

Uses the All Time Lists to collect items.

Builder Attribute: mojo_all_time

Builder Value: Dictionary of Attributes

Attribute Description
chart Determines the chart you want to use.
Allowed Values: domestic or worldwide
content_rating_filter Determines the content rating chart to use.
Allowed Values: g, g/pg, pg, pg-13, r, or nc-17
limit The maximum number of results to return.
Default Value: Returns all results
Allowed Values: Number greater than 0

Example Mojo All Time Builder(s)

collections:

  Top 100 Domestic All Time Grosses:
    mojo_all_time:
      chart: domestic
      limit: 100

  Top 100 Worldwide All Time Grosses:
    mojo_all_time:
      chart: worldwide
      limit: 100

  Top 10 Domestic All Time G Movie Grosses:
    mojo_all_time:
      chart: domestic
      content_rating_filter: g
      limit: 10

Uses the Never Hit Lists (Bottom Section) to collect items.

Builder Attribute: mojo_never

Builder Value: Dictionary of Attributes

Attribute Description
chart Determines the chart you want to use.
Allowed Values: Item in the dropdown found here
never Determines the never filter to use.
Default Value: 1
Allowed Values: 1, 5, or 10
limit The maximum number of results to return.
Default Value: Returns all results
Allowed Values: Number greater than 0

Example Mojo Never Hit Builder(s)

collections:

  "Top 100 Domestic Never #1":
    mojo_never:
      chart: domestic
      limit: 100

  "Top 100 Domestic Never #10":
    mojo_never:
      chart: domestic
      never: 10
      limit: 100

  "Top 100 German Never #1":
    mojo_never:
      chart: germany
      limit: 100

Uses the Weekend Records, Daily Records, and Miscellaneous Records to collect items.

Builder Attribute: mojo_record

Builder Value: Dictionary of Attributes

Attribute Description
chart Determines the record 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, opening_week
limit The maximum number of results to return.
Default Value: Returns all results
Allowed Values: Number greater than 0

Example Mojo Other Records Builder(s)

collections:

  Top 10 Biggest Opening Weekends:
    mojo_record:
      chart: top_opening_weekend
      limit: 10

  Top 10 Biggest Opening Day:
    mojo_record:
      chart: opening_day
      limit: 10

  Top 10 Biggest Opening Weeks:
    mojo_record:
      chart: opening_week
      limit: 10