boxofficemojo.com APIboxofficemojo.com ↗
Access Box Office Mojo data via API: daily charts, all-time rankings, movie details, release schedules, and time-series performance metrics.
curl -X GET 'https://api.parse.bot/scraper/19716ded-a751-4e1a-a385-4ee11fac2ab2/search_movies?query=Avatar' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for movies by title keyword. Returns a list of matching movies with their IMDb IDs and Box Office Mojo URLs.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Movie title search query. |
{
"type": "object",
"fields": {
"results": "array of objects with title, imdb_id, url, and metadata for each matching movie"
},
"sample": {
"data": {
"results": [
{
"url": "https://www.boxofficemojo.com/title/tt0499549/?ref_=bo_se_r_1",
"title": "Avatar",
"imdb_id": "tt0499549",
"metadata": ""
}
]
},
"status": "success"
}
}About the boxofficemojo.com API
The Box Office Mojo API exposes 6 endpoints covering movie search, detailed gross summaries, time-series performance data, and release schedules. The get_movie_details endpoint returns domestic, international, and worldwide gross totals alongside market breakdowns by region, budget, distributor, MPAA rating, and genre — all keyed by IMDb title ID.
What the API Covers
This API surfaces box office data from Box Office Mojo across six endpoints. search_movies accepts a title keyword and returns matching movies with their IMDb IDs and Box Office Mojo URLs, making it the starting point for most workflows. get_movie_details takes an imdb_id parameter and returns a summary object (domestic distributor, opening gross, budget, earliest release date, MPAA rating, running time, genres), a gross_summary with domestic, international, and worldwide totals, an array of releases with their release_id values, and a market_breakdowns object keyed by region.
Performance and Chart Endpoints
get_movie_release_performance accepts a release_id (obtainable from get_movie_details or get_daily_chart) and an optional type parameter — daily, weekend, or weekly — returning a time-series array with fields including Date, DOW, Rank, Daily earnings, Theaters, Avg, To Date, and Day count. get_daily_chart retrieves the domestic daily box office chart for a given date (YYYY-MM-DD); omitting the date returns the most recent available chart. Each row includes Release title, Daily earnings, Theaters, Avg, To Date, Days in release, Distributor, and a release_id for drilling into performance detail.
All-Time Rankings and Upcoming Releases
get_all_time_worldwide returns the all-time worldwide box office rankings with each row carrying Rank, Title, imdb_id, Worldwide Lifetime Gross, Domestic Lifetime Gross, Foreign Lifetime Gross, and Domestic percentage. No parameters are required. get_release_schedule returns upcoming theatrical releases with date, title, release_id, distributor, and release scale (wide, limited, etc.), useful for tracking the upcoming release pipeline.
- Build a dashboard that tracks daily domestic box office rankings using
get_daily_chartand refreshes each morning. - Identify all-time top-grossing films for a data journalism piece using
get_all_time_worldwidewith domestic vs. foreign breakdowns. - Pull weekly time-series performance for a specific release using
get_movie_release_performancewithtype=weeklyto model theatrical decay curves. - Enrich a film database by resolving IMDb IDs via
search_moviesand then fetching budget and genre data fromget_movie_details. - Monitor upcoming wide and limited releases by polling
get_release_schedulefor distributor and scale metadata. - Compare international market breakdowns across competing blockbusters using the
market_breakdownsfield fromget_movie_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Box Office Mojo have an official developer API?+
What does `get_movie_release_performance` return and how does the `type` parameter affect the output?+
performance key. Setting type to daily gives day-by-day rows with Date, DOW, Rank, Daily earnings, Theaters, Avg, To Date, and Day count. weekend filters to weekend frames, and weekly returns week-level aggregates. The release_id is required and can be pulled from either get_movie_details releases or a get_daily_chart row.Does the daily chart endpoint cover international markets, not just domestic?+
get_daily_chart returns the domestic (U.S.) daily chart only. International daily charts are not currently exposed as a separate endpoint. Regional gross data is available at the movie level via the market_breakdowns field in get_movie_details. You can fork this API on Parse and revise it to add an international daily chart endpoint.Is historical daily chart data available, or only recent dates?+
get_daily_chart endpoint accepts a date parameter in YYYY-MM-DD format, so historical dates can be queried individually. There is no batch or range parameter — each call returns a single date's chart. Bulk historical retrieval requires iterating over individual date calls.