Docs menu

Box Office Mojo API endpoint

Box Office Mojo release calendar API

Returns Box Office Mojo's domestic release schedule for one month, grouped by date. `year` (1921 to 2100) and `month` (1 to 12) are both required. Each release has its title, `release_url`, `distributor`, `scale`, `genres`, `cast` and poster image URLs when present.

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.calendarResponseDoc/boxofficemojo/calendar

Endpoint facts

Method: GET
API path: /boxofficemojo/calendar
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Box Office Mojo
Response schema: #/definitions/boxofficemojo.calendarResponseDoc

Box Office Mojo Scraper API Try Box Office Mojo release calendar API in Playground Box Office Mojo API documentation

How this endpoint behaves

Returns grouped rows from Box Office Mojo's public domestic release schedule.

Query parameters:

year - Required calendar year, from 1921 through 2100.
month - Required calendar month, from 1 through 12.

Notable response behavior:

The response groups scheduled releases by display date and includes release link, distributor, scale, genres, cast, and poster image URLs when present.
Parser drift, challenge pages, malformed upstream tables, or missing required schedule markers return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/calendar?month=9&year=2026
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.23 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/calendar?month=9&year=2026
Items in results: 21
Fields filled in every checked item: 2

Field	Filled in, of 21 checked	Values in the sample
date	21	“September 2, 2026” and 20 other values
releases	21	median 2 entries

Request parameters

Parameter	Type	Required	Description	Example
year	integer	Yes	Calendar year, from 1921 through 2100	2026
month	integer	Yes	Calendar month, 1 through 12	9
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/calendar?year=2026&month=9" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "year": 2026,
    "month": 9,
    "results": [
      {
        "date": "September 4, 2026",
        "releases": [
          {
            "release": "By Any Means",
            "release_path": "/release/rl564363265/",
            "distributor": "Sony Pictures Entertainment (SPE)",
            "scale": "Wide"
          }
        ]
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.calendarResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.CalendarResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.month	integer	No	9	Calendar month requested, as a number.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.results	array	No		Release dates in the month, each with the releases scheduled for it.
data.results[].date	string	No	September 4, 2026	Release date heading as shown on the calendar, for example `September 4, 2026`.
data.results[].releases	array	No		Releases scheduled for that date, one item per release.
data.results[].releases[].cast	array	No	Mark Wahlberg	Names of the cast members listed for the release.
data.results[].releases[].distributor	string	No	Sony Pictures Entertainment (SPE)	Studio or distributor handling the release.
data.results[].releases[].genres	array	No	Action	Genres listed for the release.
data.results[].releases[].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[].releases[].image_url	string	No	https://m.media-amazon.com/images/M/...jpg	URL of the poster image for the release.
data.results[].releases[].release	string	No	By Any Means	Release name as shown on the calendar.
data.results[].releases[].release_id	string	No	rl564363265	Box Office Mojo release id, starting with `rl`. Use it with the release endpoint.
data.results[].releases[].release_path	string	No	/release/rl564363265/	Path of the release page on Box Office Mojo, for example `/release/rl564363265/`.
data.results[].releases[].release_url	string	No	https://www.boxofficemojo.com/release/rl564363265/	Full URL of the release page on Box Office Mojo.
data.results[].releases[].scale	string	No	Wide	Release scale shown on the calendar, for example `Wide`.
data.results[].releases[].title_id	string	No	tt0499549	Title id of the film, starting with `tt`. Use it with the title endpoint.
data.results[].releases[].title_path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.results[].releases[].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-01/	URL of the Box Office Mojo page the data was read from.
data.year	integer	No	2026	Calendar year requested.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/calendar?year=2026&month=9" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Box Office Mojo endpoint docs Box Office Mojo Scraper API Box Office Mojo brand API documentation Box Office Mojo brands API documentation Box Office Mojo calendar changes API documentation Box Office Mojo calendar date API documentation Box Office Mojo daily box office API documentation Box Office Mojo franchise API documentation

Open in Playground Back to group

Docs menu

Box Office Mojo API endpoint

Box Office Mojo release calendar API

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.calendarResponseDoc/boxofficemojo/calendar

Endpoint facts

Method: GET
API path: /boxofficemojo/calendar
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Box Office Mojo
Response schema: #/definitions/boxofficemojo.calendarResponseDoc

Box Office Mojo Scraper API Try Box Office Mojo release calendar API in Playground Box Office Mojo API documentation

How this endpoint behaves

Returns grouped rows from Box Office Mojo's public domestic release schedule.

Query parameters:

year - Required calendar year, from 1921 through 2100.
month - Required calendar month, from 1 through 12.

Notable response behavior:

The response groups scheduled releases by display date and includes release link, distributor, scale, genres, cast, and poster image URLs when present.
Parser drift, challenge pages, malformed upstream tables, or missing required schedule markers return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/calendar?month=9&year=2026
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.23 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/calendar?month=9&year=2026
Items in results: 21
Fields filled in every checked item: 2

Field	Filled in, of 21 checked	Values in the sample
date	21	“September 2, 2026” and 20 other values
releases	21	median 2 entries

Request parameters

Parameter	Type	Required	Description	Example
year	integer	Yes	Calendar year, from 1921 through 2100	2026
month	integer	Yes	Calendar month, 1 through 12	9
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/calendar?year=2026&month=9" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "year": 2026,
    "month": 9,
    "results": [
      {
        "date": "September 4, 2026",
        "releases": [
          {
            "release": "By Any Means",
            "release_path": "/release/rl564363265/",
            "distributor": "Sony Pictures Entertainment (SPE)",
            "scale": "Wide"
          }
        ]
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.calendarResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.CalendarResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.month	integer	No	9	Calendar month requested, as a number.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.results	array	No		Release dates in the month, each with the releases scheduled for it.
data.results[].date	string	No	September 4, 2026	Release date heading as shown on the calendar, for example `September 4, 2026`.
data.results[].releases	array	No		Releases scheduled for that date, one item per release.
data.results[].releases[].cast	array	No	Mark Wahlberg	Names of the cast members listed for the release.
data.results[].releases[].distributor	string	No	Sony Pictures Entertainment (SPE)	Studio or distributor handling the release.
data.results[].releases[].genres	array	No	Action	Genres listed for the release.
data.results[].releases[].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[].releases[].image_url	string	No	https://m.media-amazon.com/images/M/...jpg	URL of the poster image for the release.
data.results[].releases[].release	string	No	By Any Means	Release name as shown on the calendar.
data.results[].releases[].release_id	string	No	rl564363265	Box Office Mojo release id, starting with `rl`. Use it with the release endpoint.
data.results[].releases[].release_path	string	No	/release/rl564363265/	Path of the release page on Box Office Mojo, for example `/release/rl564363265/`.
data.results[].releases[].release_url	string	No	https://www.boxofficemojo.com/release/rl564363265/	Full URL of the release page on Box Office Mojo.
data.results[].releases[].scale	string	No	Wide	Release scale shown on the calendar, for example `Wide`.
data.results[].releases[].title_id	string	No	tt0499549	Title id of the film, starting with `tt`. Use it with the title endpoint.
data.results[].releases[].title_path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.results[].releases[].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-01/	URL of the Box Office Mojo page the data was read from.
data.year	integer	No	2026	Calendar year requested.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/calendar?year=2026&month=9" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Box Office Mojo release calendar API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Box Office Mojo release calendar API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related