Box Office Mojo API endpoint
Returns the releases scheduled on one date in Box Office Mojo's domestic release schedule. `date` is required, in `YYYY-MM-DD` form. Each release has its title, `release_url`, `distributor`, `scale`, `genres`, `cast` and poster image URLs when present. A date with no scheduled releases returns a not-found error.
/boxofficemojo/calendar/dateQuery parameters:
date - Required calendar date in YYYY-MM-DD format.Notable response behavior:
| Field | Filled in, of 23 checked | Values in the sample |
|---|---|---|
| release | 23 | “By Any Means” and 22 other values |
| release_path | 23 | “/release/rl564363265/” and 22 other values |
| release_url | 23 | boxofficemojo.com |
| release_id | 23 | |
| title_id | 23 | |
| title_path | 23 | “/title/tt34379051/” and 22 other values |
| title_url | 23 | boxofficemojo.com |
| distributor | 23 | “Paramount Pictures” and 20 other values |
| scale | 23 | Limited (20), Wide (3) |
| genres | 23 | median 3 entries |
| cast | 22 | median 4 entries |
| image_url | 23 | m.media-amazon.com |
| image_hi_res_url | 23 | m.media-amazon.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| date | string | Yes | Calendar date in YYYY-MM-DD format | 2026-09-04 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/calendar/date?date=2026-09-04" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"date": "2026-09-04",
"results": [
{
"release": "By Any Means",
"release_path": "/release/rl564363265/",
"scale": "Wide"
}
],
"public_page_derived": true
}
}Request schema
No body schema
Response schema
#/definitions/boxofficemojo.calendarDateResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | boxofficemojo.CalendarDateResponse | No | ||||
| data.date | string | No | 2026-09-04 | Release date requested, in YYYY-MM-DD. | ||
| data.fetched_at | string | No | 2026-06-07T14:46:16Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.public_page_derived | boolean | No | true | Always `true`; the values come from Box Office Mojo's public pages. | ||
| data.results | array | No | Releases scheduled for that date, one item per release. | |||
| data.results[].cast | array | No | Mark Wahlberg | Names of the cast members listed for the release. | ||
| data.results[].distributor | string | No | Sony Pictures Entertainment (SPE) | Studio or distributor handling the release. | ||
| data.results[].genres | array | No | Action | Genres listed for the release. | ||
| data.results[].image_hi_res_url | string | No | https://m.media-amazon.com/images/M/...jpg | URL of the larger poster image for the release. | ||
| data.results[].image_url | string | No | https://m.media-amazon.com/images/M/...jpg | URL of the poster image for the release. | ||
| data.results[].release | string | No | By Any Means | Release name as shown on the calendar. | ||
| data.results[].release_id | string | No | rl564363265 | Box Office Mojo release id, starting with `rl`. Use it with the release endpoint. | ||
| data.results[].release_path | string | No | /release/rl564363265/ | Path of the release page on Box Office Mojo, for example `/release/rl564363265/`. | ||
| data.results[].release_url | string | No | https://www.boxofficemojo.com/release/rl564363265/ | Full URL of the release page on Box Office Mojo. | ||
| data.results[].scale | string | No | Wide | Release scale shown on the calendar, for example `Wide`. | ||
| data.results[].title_id | string | No | tt0499549 | Title id of the film, starting with `tt`. Use it with the title endpoint. | ||
| data.results[].title_path | string | No | /title/tt0499549/ | Path of the title page on Box Office Mojo, for example `/title/tt0499549/`. | ||
| data.results[].title_url | string | No | https://www.boxofficemojo.com/title/tt0499549/ | Full URL of the title page on Box Office Mojo. | ||
| data.source_url | string | No | https://www.boxofficemojo.com/calendar/2026-09-04/ | URL of the Box Office Mojo page the data was read from. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/calendar/date?date=2026-09-04" \
-H "x-api-key: $CRAWLORA_API_KEY"