The Numbers Box Office Scraper

Scrape The Numbers — one of the web's most detailed free sources of movie box-office and financial data. Get weekend, daily, and weekly box-office charts, yearly top-grossing rankings, and per-movie financials (production budget, domestic/international/worldwide gross, opening weekend, theater counts, MPA rating, and more) by title. HTTP-only, no login, no paywall.

What this actor does

• Six modes: weekend, daily, weekly box-office charts, yearly top-grossing rankings, byTitle movie financial lookup, and releaseSchedule upcoming/just-released movie schedule
• Full financial profile per movie: production budget, domestic/international/worldwide box office, opening weekend gross & share, "legs" multiplier, inflation-adjusted domestic gross, theater counts, MPA rating, running time, genre, distributor, release date
• Filters: minimum gross, distributor (yearly / releaseSchedule modes), genre (yearly mode)
• Empty fields are omitted — a field only appears when The Numbers actually publishes that data point for the movie

Output per record

Box-office chart entry (weekend / daily / weekly)

• rank, previousRank, isNewEntry
• title, detailUrl
• gross, isEstimate, totalGross
• dailyChangePercent, weeklyChangePercent
• theaterCount, theaterAverage, daysInRelease
• chartType, chartDate
• recordType: "boxOfficeChartEntry", scrapedAt

Yearly top-grossing entry (yearly)

• rank, title, detailUrl, year
• releaseDate, distributor, genre
• grossForYear, ticketsSold
• recordType: "yearlyBoxOfficeEntry", scrapedAt

Movie financials (byTitle)

• title, year, posterUrl, leadCast, director
• domesticBoxOffice, internationalBoxOffice, worldwideBoxOffice, inflationAdjustedDomesticBoxOffice
• openingWeekendGross, openingWeekendPercent, legs, domesticSharePercent
• productionBudget
• openingTheaters, maxTheaters, avgWeeksPerTheater
• domesticReleaseDate, distributor, mpaRating, runningTimeMinutes
• genre, subgenre, franchise, source, productionMethod, creativeType
• productionCompanies, productionCountries, languages
• sourceUrl, recordType: "movieFinancials", scrapedAt

Release schedule entry (releaseSchedule)

• title, detailUrl
• releaseDate — YYYY-MM-DD
• releaseType — e.g. Wide, Limited, Expands Wide, IMAX, Special Engagement, Wide, re-release, Canceled
• distributor
• domesticBoxOfficeToDate — populated only once the movie has opened and started earning
• recordType: "releaseScheduleEntry", scrapedAt

Input

Field	Type	Default	Description
mode	string	weekend	weekend / daily / weekly / yearly / byTitle / releaseSchedule
chartDate	string	–	YYYY-MM-DD. Weekend/weekly snap to the nearest Friday on/before this date. Blank = most recent chart.
year	int	2026	Calendar year for yearly mode (1980–current year)
movieTitle	string	Avatar	Title to search for (byTitle mode)
minGross	int	–	Drop entries below this gross
distributor	string	–	Substring filter on distributor (yearly / releaseSchedule modes)
genre	string	–	Substring filter on genre (yearly mode)
maxItems	int	20	Hard cap on emitted records (1–200)
proxyConfiguration	object	AUTO	Not required for reliable access; kept as a resilience fallback

Example: this weekend's box office

{ "mode": "weekend", "maxItems": 20 }

Example: daily chart for a specific date

{ "mode": "daily", "chartDate": "2026-07-04", "maxItems": 20 }

Example: 2025's top-grossing movies from Walt Disney

{ "mode": "yearly", "year": 2025, "distributor": "Walt Disney", "maxItems": 50 }

Example: movie financials by title

{ "mode": "byTitle", "movieTitle": "Toy Story", "maxItems": 10 }

Example: upcoming Walt Disney releases

{ "mode": "releaseSchedule", "distributor": "Walt Disney", "maxItems": 50 }

Use cases

• Box-office trackers — pull the current weekend/daily chart into a dashboard
• Film industry research — build datasets of budgets vs. gross by year/distributor
• Investment & greenlight analysis — compare production budget to worldwide gross ("legs", ROI multiples)
• Media & journalism — source up-to-date box-office figures for reporting
• Academic research — study box-office trends by genre, studio, or release year

FAQ

What's The Numbers? A free, publicly accessible movie-industry data site tracking box office, budgets, and release schedules since the late 1990s.

How far back does the data go? Daily/weekend/weekly charts are reliably available from 1998 onward; yearly top-grossing charts from 1980 onward. Older dates return an empty result with a status message rather than an error.

Why do some movies lack productionBudget? Budgets are self-reported/estimated by the industry and not disclosed for every film (especially independent or foreign releases). The field is simply omitted rather than emitted as null or a placeholder.

What does isNewEntry mean? true when the chart shows (new) in the "Prev" column — the movie has no prior-week ranking. previousRank is omitted in that case (there is no previous rank to report).

What does legs mean? The Numbers' "legs" metric = domestic box office ÷ biggest single weekend. Higher values indicate a film held well over its run rather than front-loading its gross.

Does byTitle return multiple movies for the same title? Yes — franchises and remakes share titles (e.g. "Toy Story" has five entries). The actor returns every distinct match up to maxItems; check the year field to disambiguate.

Is a proxy required? No. The Numbers serves all covered pages to Apify's datacenter IPs without blocking. proxyConfiguration is exposed only as a resilience fallback (Apify's free AUTO group).

What does releaseSchedule mode return? The Numbers' full upcoming-release calendar — every movie with a confirmed or announced release date, starting from today, plus already-open movies whose domestic box-office-to-date is still being tracked. domesticBoxOfficeToDate is omitted until the movie has actually opened.

Does this cover everything on The Numbers? This actor covers every reliable, free chart/lookup axis The Numbers exposes: daily/weekend/weekly box-office charts, yearly top-grossing rankings, per-title financial lookup, and the release schedule. A few additional axes visible in the site's navigation are intentionally out of scope: per-distributor lifetime totals (/market/distributor/<name> returns HTTP 404 for the slugs tested — not a reliably available public page), and "Bankability" talent-value reports and The Numbers Business Report, which are subscriber-only features behind a paywall.