Docs menu

Box Office Mojo API endpoint

Box Office Mojo release detail API

Returns Box Office Mojo release summary fields and domestic daily rows from a release page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.releaseResponseDoc/boxofficemojo/release

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

id - Optional Box Office Mojo release id, such as rl3389031937.
path - Optional Box Office Mojo release path, such as /release/rl3389031937/.
url - Optional absolute https://www.boxofficemojo.com release URL.

Notable response behavior:

The response includes title, release id, source URL, summary fields, and domestic daily rows.
Parser drift, challenge pages, malformed upstream tables, or missing required release markers return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/release?id=rl3389031937
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.03 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/release?id=rl3389031937
Items in daily_grosses: 119
Fields filled in every checked item: 11
Fields empty in some or all items: 2

Field	Filled in, of 119 checked	Values in the sample
date	119	“Dec 19” and 118 other values
day_of_week	119	Friday (17), Saturday (17), Sunday (17) and 4 more
rank	119	1 to 24, median 8
daily_gross	119	1,735 to 36,486,725, median 391,487
daily_gross_raw	119	“$36,486,725” and 118 other values
theaters	119	35 to 3,835, median 1,650
average	119	37 to 9,601, median 303
average_raw	119	“$9,601” and 110 other values
total_gross	119	36,486,725 to 404,340,010, median 396,918,558
total_gross_raw	119	“$36,486,725” and 118 other values
day	119	1 to 119, median 60
day_change	118	-0.78 to 2.37, median -0.15
week_change	112	-0.84 to 1.15, median -0.39

Request parameters

Parameter	Type	Required	Description	Example
id	string	No	Box Office Mojo release id	rl3389031937
path	string	No	Box Office Mojo release path	/release/rl3389031937/
url	string	No	Absolute https://www.boxofficemojo.com release URL	https://www.boxofficemojo.com/release/rl3389031937/
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/release" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Avatar: Fire and Ash",
    "release_id": "rl3389031937",
    "summary": {
      "distributor": "20th Century Studios",
      "opening_raw": "$89,160,860"
    },
    "daily_grosses": [
      {
        "date": "Dec 25",
        "daily_gross_raw": "$24,096,415"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.releaseResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	boxofficemojo.ReleaseResponse	No
data.daily_grosses	array	No
data.daily_grosses[].average	integer	No	6341
data.daily_grosses[].average_raw	string	No	$6,341
data.daily_grosses[].daily_gross	integer	No	24123456
data.daily_grosses[].daily_gross_raw	string	No	$24,123,456
data.daily_grosses[].date	string	No	Dec 19
data.daily_grosses[].day	integer	No	7
data.daily_grosses[].day_change	number	No	0.124
data.daily_grosses[].day_of_week	string	No	Fri
data.daily_grosses[].rank	integer	No	1
data.daily_grosses[].theaters	integer	No	3800
data.daily_grosses[].total_gross	integer	No	153827123
data.daily_grosses[].total_gross_raw	string	No	$153,827,123
data.daily_grosses[].week_change	number	No	-0.141
data.fetched_at	string	No	2026-06-07T14:46:16Z
data.path	string	No	/release/rl3389031937/
data.public_page_derived	boolean	No	true
data.release_id	string	No	rl3389031937
data.source_url	string	No	https://www.boxofficemojo.com/release/rl3389031937/
data.summary	boxofficemojo.ReleaseSummary	No
data.summary.budget	integer	No	400000000
data.summary.budget_raw	string	No	$400,000,000
data.summary.distributor	string	No	20th Century Studios
data.summary.genres	string	No	Action Adventure Fantasy Sci-Fi
data.summary.mpaa	string	No	PG-13
data.summary.opening	integer	No	89160860
data.summary.opening_raw	string	No	$89,160,860
data.summary.opening_theaters	integer	No	3800
data.summary.release_date	string	No	Dec 19, 2025 - Apr 16, 2026
data.summary.running_time	string	No	3 hr 17 min
data.summary.widest_release	integer	No	3835
data.summary.widest_release_raw	string	No	3,835 theaters
data.title	string	No	Avatar: Fire and Ash
data.title_id	string	No	tt0499549
data.title_path	string	No	/title/tt0499549/
data.title_url	string	No	https://www.boxofficemojo.com/title/tt0499549/
data.url	string	No	https://www.boxofficemojo.com/release/rl3389031937/
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/release" \
  -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 daily box office API documentation

Open in Playground Back to group

Docs menu

Box Office Mojo API endpoint

Box Office Mojo release detail API

Returns Box Office Mojo release summary fields and domestic daily rows from a release page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.releaseResponseDoc/boxofficemojo/release

Endpoint facts

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

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

How this endpoint behaves

Query parameters:

id - Optional Box Office Mojo release id, such as rl3389031937.
path - Optional Box Office Mojo release path, such as /release/rl3389031937/.
url - Optional absolute https://www.boxofficemojo.com release URL.

Notable response behavior:

The response includes title, release id, source URL, summary fields, and domestic daily rows.
Parser drift, challenge pages, malformed upstream tables, or missing required release markers return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/release?id=rl3389031937
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.03 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/release?id=rl3389031937
Items in daily_grosses: 119
Fields filled in every checked item: 11
Fields empty in some or all items: 2

Field	Filled in, of 119 checked	Values in the sample
date	119	“Dec 19” and 118 other values
day_of_week	119	Friday (17), Saturday (17), Sunday (17) and 4 more
rank	119	1 to 24, median 8
daily_gross	119	1,735 to 36,486,725, median 391,487
daily_gross_raw	119	“$36,486,725” and 118 other values
theaters	119	35 to 3,835, median 1,650
average	119	37 to 9,601, median 303
average_raw	119	“$9,601” and 110 other values
total_gross	119	36,486,725 to 404,340,010, median 396,918,558
total_gross_raw	119	“$36,486,725” and 118 other values
day	119	1 to 119, median 60
day_change	118	-0.78 to 2.37, median -0.15
week_change	112	-0.84 to 1.15, median -0.39

Request parameters

Parameter	Type	Required	Description	Example
id	string	No	Box Office Mojo release id	rl3389031937
path	string	No	Box Office Mojo release path	/release/rl3389031937/
url	string	No	Absolute https://www.boxofficemojo.com release URL	https://www.boxofficemojo.com/release/rl3389031937/
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/release" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Avatar: Fire and Ash",
    "release_id": "rl3389031937",
    "summary": {
      "distributor": "20th Century Studios",
      "opening_raw": "$89,160,860"
    },
    "daily_grosses": [
      {
        "date": "Dec 25",
        "daily_gross_raw": "$24,096,415"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.releaseResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	boxofficemojo.ReleaseResponse	No
data.daily_grosses	array	No
data.daily_grosses[].average	integer	No	6341
data.daily_grosses[].average_raw	string	No	$6,341
data.daily_grosses[].daily_gross	integer	No	24123456
data.daily_grosses[].daily_gross_raw	string	No	$24,123,456
data.daily_grosses[].date	string	No	Dec 19
data.daily_grosses[].day	integer	No	7
data.daily_grosses[].day_change	number	No	0.124
data.daily_grosses[].day_of_week	string	No	Fri
data.daily_grosses[].rank	integer	No	1
data.daily_grosses[].theaters	integer	No	3800
data.daily_grosses[].total_gross	integer	No	153827123
data.daily_grosses[].total_gross_raw	string	No	$153,827,123
data.daily_grosses[].week_change	number	No	-0.141
data.fetched_at	string	No	2026-06-07T14:46:16Z
data.path	string	No	/release/rl3389031937/
data.public_page_derived	boolean	No	true
data.release_id	string	No	rl3389031937
data.source_url	string	No	https://www.boxofficemojo.com/release/rl3389031937/
data.summary	boxofficemojo.ReleaseSummary	No
data.summary.budget	integer	No	400000000
data.summary.budget_raw	string	No	$400,000,000
data.summary.distributor	string	No	20th Century Studios
data.summary.genres	string	No	Action Adventure Fantasy Sci-Fi
data.summary.mpaa	string	No	PG-13
data.summary.opening	integer	No	89160860
data.summary.opening_raw	string	No	$89,160,860
data.summary.opening_theaters	integer	No	3800
data.summary.release_date	string	No	Dec 19, 2025 - Apr 16, 2026
data.summary.running_time	string	No	3 hr 17 min
data.summary.widest_release	integer	No	3835
data.summary.widest_release_raw	string	No	3,835 theaters
data.title	string	No	Avatar: Fire and Ash
data.title_id	string	No	tt0499549
data.title_path	string	No	/title/tt0499549/
data.title_url	string	No	https://www.boxofficemojo.com/title/tt0499549/
data.url	string	No	https://www.boxofficemojo.com/release/rl3389031937/
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/release" \
  -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 detail 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 detail 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