Docs menu

Box Office Mojo API endpoint

Box Office Mojo daily box office API

Returns rows from Box Office Mojo's domestic daily chart. Empty upstream daily pages return a typed not-found error rather than an empty success.

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.domesticDateResponseDoc/boxofficemojo/date/domestic

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo daily box office API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

date - Required domestic box office date in YYYY-MM-DD format. The date year must be from 1982 through 2100.

Notable response behavior:

The response includes the requested date, source URL, fetch time, and daily rows.
Empty upstream daily pages return a typed not-found error rather than an empty success payload.
Parser drift, challenge pages, or malformed upstream tables return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/date/domestic?date=2025-12-25
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.90 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/date/domestic?date=2025-12-25
Items in results: 34
Fields filled in every checked item: 13
Fields empty in some or all items: 3

Field	Filled in, of 34 checked	Values in the sample
rank	34	1 to 34, median 17
yesterday_rank	29	1 to 30, median 15
release	34	“Avatar: Fire and Ash” and 33 other values
release_path	34	“/release/rl3389031937/” and 33 other values
release_url	34	boxofficemojo.com
daily_gross	34	70 to 24,096,415, median 39,552
daily_gross_raw	34	“$24,096,415” and 33 other values
day_change	27	-0.89 to 3.74, median 0.62
theaters	34	2 to 3,800, median 133
average	34	7 to 24,074, median 399
average_raw	34	“$6,341” and 32 other values
total_gross	34	11,543 to 326,363,190, median 4,425,455
total_gross_raw	34	“$153,827,123” and 33 other values
days	34	1 to 105, median 21
distributor	34	“20th Century Studios” and 16 other values
week_change	21	-0.95 to 1.98, median -0.35

Request parameters

Parameter	Type	Required	Default	Description	Example
date	string	Yes		Domestic box office date in YYYY-MM-DD format	2025-12-25
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/date/domestic?date=2025-12-25" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "date": "2025-12-25",
    "results": [
      {
        "rank": 1,
        "release": "Avatar: Fire and Ash",
        "daily_gross_raw": "$24,631,680"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.domesticDateResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.DomesticDateResponse	No
data.date	string	No	2025-12-25	Day 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		Rows of the domestic daily chart, one per release, in chart order.
data.results[].average	integer	No	6482	Average gross per theater for the day, in US dollars.
data.results[].average_raw	string	No	$6,482	Average gross per theater, as Box Office Mojo displays it, for example `$6,482`.
data.results[].daily_gross	integer	No	24631680	Domestic gross for the day, in US dollars.
data.results[].daily_gross_raw	string	No	$24,631,680	Daily domestic gross, as Box Office Mojo displays it, for example `$24,631,680`.
data.results[].day_change	number	No	0.122	Change in daily gross from the previous day, as a fraction (0.122 is +12.2%).
data.results[].days	integer	No	8	Number of days the release has been in theaters, as shown in the Days column.
data.results[].distributor	string	No	20th Century Studios	Studio or distributor handling the release.
data.results[].rank	integer	No	1	Position on this day's chart.
data.results[].release	string	No	Avatar: Fire and Ash	Release name as shown on the daily chart.
data.results[].release_path	string	No	/release/rl3389031937/	Path of the release page on Box Office Mojo, for example `/release/rl3389031937/`.
data.results[].release_url	string	No	https://www.boxofficemojo.com/release/rl3389031937/	Full URL of the release page on Box Office Mojo.
data.results[].theaters	integer	No	3800	Number of theaters showing the release that day.
data.results[].total_gross	integer	No	153827123	Domestic gross of the release to date, in US dollars.
data.results[].total_gross_raw	string	No	$153,827,123	Domestic gross to date, as Box Office Mojo displays it, for example `$153,827,123`.
data.results[].week_change	number	No	-0.141	Change in daily gross from the same day last week, as a fraction (-0.141 is -14.1%).
data.results[].yesterday_rank	integer	No	1	Position on the previous day's chart.
data.source_url	string	No	https://www.boxofficemojo.com/date/2025-12-25/	URL of the Box Office Mojo page the data was read from.
msg	string	No	OK

Failure responses

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

Code examples

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

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/date/domestic?date=2025-12-25" \
  -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 release calendar API documentation Box Office Mojo calendar changes API documentation Box Office Mojo calendar date API documentation Box Office Mojo franchise API documentation

Open in Playground Back to group

Docs menu

Box Office Mojo API endpoint

Box Office Mojo daily box office API

Returns rows from Box Office Mojo's domestic daily chart. Empty upstream daily pages return a typed not-found error rather than an empty success.

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.domesticDateResponseDoc/boxofficemojo/date/domestic

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo daily box office API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

date - Required domestic box office date in YYYY-MM-DD format. The date year must be from 1982 through 2100.

Notable response behavior:

The response includes the requested date, source URL, fetch time, and daily rows.
Empty upstream daily pages return a typed not-found error rather than an empty success payload.
Parser drift, challenge pages, or malformed upstream tables return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/date/domestic?date=2025-12-25
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.90 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/date/domestic?date=2025-12-25
Items in results: 34
Fields filled in every checked item: 13
Fields empty in some or all items: 3

Field	Filled in, of 34 checked	Values in the sample
rank	34	1 to 34, median 17
yesterday_rank	29	1 to 30, median 15
release	34	“Avatar: Fire and Ash” and 33 other values
release_path	34	“/release/rl3389031937/” and 33 other values
release_url	34	boxofficemojo.com
daily_gross	34	70 to 24,096,415, median 39,552
daily_gross_raw	34	“$24,096,415” and 33 other values
day_change	27	-0.89 to 3.74, median 0.62
theaters	34	2 to 3,800, median 133
average	34	7 to 24,074, median 399
average_raw	34	“$6,341” and 32 other values
total_gross	34	11,543 to 326,363,190, median 4,425,455
total_gross_raw	34	“$153,827,123” and 33 other values
days	34	1 to 105, median 21
distributor	34	“20th Century Studios” and 16 other values
week_change	21	-0.95 to 1.98, median -0.35

Request parameters

Parameter	Type	Required	Default	Description	Example
date	string	Yes		Domestic box office date in YYYY-MM-DD format	2025-12-25
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/date/domestic?date=2025-12-25" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "date": "2025-12-25",
    "results": [
      {
        "rank": 1,
        "release": "Avatar: Fire and Ash",
        "daily_gross_raw": "$24,631,680"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.domesticDateResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.DomesticDateResponse	No
data.date	string	No	2025-12-25	Day 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		Rows of the domestic daily chart, one per release, in chart order.
data.results[].average	integer	No	6482	Average gross per theater for the day, in US dollars.
data.results[].average_raw	string	No	$6,482	Average gross per theater, as Box Office Mojo displays it, for example `$6,482`.
data.results[].daily_gross	integer	No	24631680	Domestic gross for the day, in US dollars.
data.results[].daily_gross_raw	string	No	$24,631,680	Daily domestic gross, as Box Office Mojo displays it, for example `$24,631,680`.
data.results[].day_change	number	No	0.122	Change in daily gross from the previous day, as a fraction (0.122 is +12.2%).
data.results[].days	integer	No	8	Number of days the release has been in theaters, as shown in the Days column.
data.results[].distributor	string	No	20th Century Studios	Studio or distributor handling the release.
data.results[].rank	integer	No	1	Position on this day's chart.
data.results[].release	string	No	Avatar: Fire and Ash	Release name as shown on the daily chart.
data.results[].release_path	string	No	/release/rl3389031937/	Path of the release page on Box Office Mojo, for example `/release/rl3389031937/`.
data.results[].release_url	string	No	https://www.boxofficemojo.com/release/rl3389031937/	Full URL of the release page on Box Office Mojo.
data.results[].theaters	integer	No	3800	Number of theaters showing the release that day.
data.results[].total_gross	integer	No	153827123	Domestic gross of the release to date, in US dollars.
data.results[].total_gross_raw	string	No	$153,827,123	Domestic gross to date, as Box Office Mojo displays it, for example `$153,827,123`.
data.results[].week_change	number	No	-0.141	Change in daily gross from the same day last week, as a fraction (-0.141 is -14.1%).
data.results[].yesterday_rank	integer	No	1	Position on the previous day's chart.
data.source_url	string	No	https://www.boxofficemojo.com/date/2025-12-25/	URL of the Box Office Mojo page the data was read from.
msg	string	No	OK

Failure responses

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

Code examples

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

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/date/domestic?date=2025-12-25" \
  -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 daily box office 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 daily box office 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