Docs menu

Box Office Mojo API endpoint

Box Office Mojo showdown API

Returns release comparison metrics from a Box Office Mojo showdown page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.showdownResponseDoc/boxofficemojo/showdown

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo showdown API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters: pass exactly one of id, path, or url.

Notable response behavior: id values must look like sd943519236; path values must look like /showdown/sd943519236/; url values must be absolute https://www.boxofficemojo.com/showdown/.../ URLs. Parser drift or upstream block pages return an upstream error instead of 200 [].

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/showdown?id=sd943519236
Items in releases: 4
Fields filled in every checked item: 26
Fields empty in some or all items: 1

Field	Filled in, of 4 checked	Values in the sample
release	4	“The Intern” and 3 other values
release_path	4	“/release/rl861570561/” and 3 other values
release_url	4	boxofficemojo.com
genre	4	“Comedy” and 3 other values
distributor	4	“Warner Bros.” and 2 other values
release_date	4	“Sep 25, 2015” and 3 other values
gross_to_date	4	63,224,849 to 124,728,738, median 75,764,672
gross_to_date_raw	4	“$75,764,672” and 3 other values
production_budget	4	35,000,000 to 85,000,000, median 80,000,000
production_budget_raw	4	“$35,000,000” and 2 other values
running_time	4	“2 hr 1 min” and 2 other values
mpa_rating	4	PG-13 (3), R (1)
domestic_gross	4	63,224,849 to 124,728,738, median 75,764,672
domestic_gross_raw	4	“$75,764,672” and 3 other values
opening_weekend	4	12,778,913 to 22,100,820, median 16,064,723
opening_weekend_raw	4	“$17,728,313” and 3 other values
opening_share	4	0.13 to 0.23, median 0.2
widest_release	4	2,698 to 3,320, median 2,876
close_date	4	“Jan 7, 2016” and 3 other values
weekends_in_top_ten	4	4 to 7, median 6
worldwide_gross	4	194,764,672 to 265,328,738, median 205,169,597
worldwide_gross_raw	4	“$194,764,672” and 3 other values
foreign_gross	4	106,368,280 to 141,910,326, median 119,000,000
foreign_gross_raw	4	“$119,000,000” and 3 other values
foreign_share	4	0.49 to 0.69, median 0.53
domestic_share	4	0.31 to 0.52, median 0.39
weekends_at_number_one	1	1

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "name": "Marvel Cinematic Universe vs. DC Extended Universe",
    "id": "sd943519236",
    "results": [
      {
        "rank": 1,
        "title": "The Avengers",
        "title_id": "tt0848228",
        "domestic_gross": 623357910,
        "opening": 207438708,
        "release_date": "2012-05-04"
      }
    ],
    "summary": {
      "movie_count": 37,
      "top_release": "The Avengers"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.showdownResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.ShowdownResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.name	string	No	12 Years of Nancy Meyers	Showdown name, for example `12 Years of Nancy Meyers`.
data.path	string	No	/showdown/sd943519236/	Path of the showdown page on Box Office Mojo, for example `/showdown/sd943519236/`.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.releases	array	No		Releases compared in the showdown, one item per release.
data.releases[].close_date	string	No	Jan 7, 2016	Date the release left theaters, as shown on the showdown page.
data.releases[].distributor	string	No	Warner Bros.	Studio or distributor handling the release.
data.releases[].domestic_gross	integer	No	75764672	Domestic gross of the release, in US dollars.
data.releases[].domestic_gross_raw	string	No	$75,764,672	Domestic gross, as Box Office Mojo displays it, for example `$75,764,672`.
data.releases[].domestic_share	number	No	0.389	Domestic gross as a fraction of worldwide gross (0.389 is 38.9%).
data.releases[].foreign_gross	integer	No	119000000	Foreign gross of the release, in US dollars.
data.releases[].foreign_gross_raw	string	No	$119,000,000	Foreign gross, as Box Office Mojo displays it, for example `$119,000,000`.
data.releases[].foreign_share	number	No	0.611	Foreign gross as a fraction of worldwide gross (0.611 is 61.1%).
data.releases[].genre	string	No	Comedy Drama	Genre label shown for the release, for example `Comedy Drama`.
data.releases[].gross_to_date	integer	No	75764672	Gross of the release to date, in US dollars.
data.releases[].gross_to_date_raw	string	No	$75,764,672	Gross to date, as Box Office Mojo displays it, for example `$75,764,672`.
data.releases[].mpa_rating	string	No	PG-13	MPA rating of the release, for example `PG-13`.
data.releases[].opening_share	number	No	0.234	Opening weekend gross as a fraction of total gross (0.234 is 23.4%).
data.releases[].opening_weekend	integer	No	17728313	Opening weekend gross, in US dollars.
data.releases[].opening_weekend_raw	string	No	$17,728,313	Opening weekend gross, as Box Office Mojo displays it, for example `$17,728,313`.
data.releases[].production_budget	integer	No	35000000	Production budget of the release, in US dollars.
data.releases[].production_budget_raw	string	No	$35,000,000	Production budget, as Box Office Mojo displays it, for example `$35,000,000`.
data.releases[].release	string	No	The Intern	Release name as shown on the showdown page.
data.releases[].release_date	string	No	Sep 25, 2015	Release date as shown on the showdown page, for example `Sep 25, 2015`.
data.releases[].release_path	string	No	/release/rl861570561/	Path of the release page on Box Office Mojo, for example `/release/rl861570561/`.
data.releases[].release_url	string	No	https://www.boxofficemojo.com/release/rl861570561/	Full URL of the release page on Box Office Mojo.
data.releases[].running_time	string	No	2 hr 1 min	Running time as shown, for example `2 hr 1 min`.
data.releases[].weekends_at_number_one	integer	No	0	Number of weekends the release ranked first on the domestic weekend chart.
data.releases[].weekends_in_top_ten	integer	No	6	Number of weekends the release ranked in the top ten of the domestic weekend chart.
data.releases[].widest_release	integer	No	3320	Largest number of theaters the release played in at once.
data.releases[].worldwide_gross	integer	No	194764672	Worldwide gross of the release, in US dollars.
data.releases[].worldwide_gross_raw	string	No	$194,764,672	Worldwide gross, as Box Office Mojo displays it, for example `$194,764,672`.
data.showdown_id	string	No	sd943519236	Box Office Mojo showdown id, starting with `sd`.
data.source_url	string	No	https://www.boxofficemojo.com/showdown/sd943519236/	URL of the Box Office Mojo page the data was read from.
data.summary	object	No		Totals and leaders computed across the releases in the showdown.
data.summary.highest_opening_release	string	No	It's Complicated	Release with the highest opening weekend gross in the showdown.
data.summary.highest_opening_weekend	integer	No	22100820	Opening weekend gross of that release, in US dollars.
data.summary.release_count	integer	No	4	Number of releases in the showdown.
data.summary.top_domestic_gross	integer	No	124728738	Domestic gross of the top domestic release, in US dollars.
data.summary.top_domestic_release	string	No	Something's Gotta Give	Release with the highest domestic gross in the showdown.
data.summary.top_worldwide_gross	integer	No	265328738	Worldwide gross of the top worldwide release, in US dollars.
data.summary.top_worldwide_release	string	No	Something's Gotta Give	Release with the highest worldwide gross in the showdown.
data.summary.total_domestic_gross	integer	No	376453634	Combined domestic gross of the releases in the showdown, in US dollars.
data.summary.total_worldwide_gross	integer	No	884396662	Combined worldwide gross of the releases in the showdown, in US dollars.
data.url	string	No	https://www.boxofficemojo.com/showdown/sd943519236/	Full URL of the showdown page on Box Office Mojo.
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/showdown" \
  -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 showdown API

Returns release comparison metrics from a Box Office Mojo showdown page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.showdownResponseDoc/boxofficemojo/showdown

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo showdown API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters: pass exactly one of id, path, or url.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/showdown?id=sd943519236
Items in releases: 4
Fields filled in every checked item: 26
Fields empty in some or all items: 1

Field	Filled in, of 4 checked	Values in the sample
release	4	“The Intern” and 3 other values
release_path	4	“/release/rl861570561/” and 3 other values
release_url	4	boxofficemojo.com
genre	4	“Comedy” and 3 other values
distributor	4	“Warner Bros.” and 2 other values
release_date	4	“Sep 25, 2015” and 3 other values
gross_to_date	4	63,224,849 to 124,728,738, median 75,764,672
gross_to_date_raw	4	“$75,764,672” and 3 other values
production_budget	4	35,000,000 to 85,000,000, median 80,000,000
production_budget_raw	4	“$35,000,000” and 2 other values
running_time	4	“2 hr 1 min” and 2 other values
mpa_rating	4	PG-13 (3), R (1)
domestic_gross	4	63,224,849 to 124,728,738, median 75,764,672
domestic_gross_raw	4	“$75,764,672” and 3 other values
opening_weekend	4	12,778,913 to 22,100,820, median 16,064,723
opening_weekend_raw	4	“$17,728,313” and 3 other values
opening_share	4	0.13 to 0.23, median 0.2
widest_release	4	2,698 to 3,320, median 2,876
close_date	4	“Jan 7, 2016” and 3 other values
weekends_in_top_ten	4	4 to 7, median 6
worldwide_gross	4	194,764,672 to 265,328,738, median 205,169,597
worldwide_gross_raw	4	“$194,764,672” and 3 other values
foreign_gross	4	106,368,280 to 141,910,326, median 119,000,000
foreign_gross_raw	4	“$119,000,000” and 3 other values
foreign_share	4	0.49 to 0.69, median 0.53
domestic_share	4	0.31 to 0.52, median 0.39
weekends_at_number_one	1	1

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "name": "Marvel Cinematic Universe vs. DC Extended Universe",
    "id": "sd943519236",
    "results": [
      {
        "rank": 1,
        "title": "The Avengers",
        "title_id": "tt0848228",
        "domestic_gross": 623357910,
        "opening": 207438708,
        "release_date": "2012-05-04"
      }
    ],
    "summary": {
      "movie_count": 37,
      "top_release": "The Avengers"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.showdownResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.ShowdownResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.name	string	No	12 Years of Nancy Meyers	Showdown name, for example `12 Years of Nancy Meyers`.
data.path	string	No	/showdown/sd943519236/	Path of the showdown page on Box Office Mojo, for example `/showdown/sd943519236/`.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.releases	array	No		Releases compared in the showdown, one item per release.
data.releases[].close_date	string	No	Jan 7, 2016	Date the release left theaters, as shown on the showdown page.
data.releases[].distributor	string	No	Warner Bros.	Studio or distributor handling the release.
data.releases[].domestic_gross	integer	No	75764672	Domestic gross of the release, in US dollars.
data.releases[].domestic_gross_raw	string	No	$75,764,672	Domestic gross, as Box Office Mojo displays it, for example `$75,764,672`.
data.releases[].domestic_share	number	No	0.389	Domestic gross as a fraction of worldwide gross (0.389 is 38.9%).
data.releases[].foreign_gross	integer	No	119000000	Foreign gross of the release, in US dollars.
data.releases[].foreign_gross_raw	string	No	$119,000,000	Foreign gross, as Box Office Mojo displays it, for example `$119,000,000`.
data.releases[].foreign_share	number	No	0.611	Foreign gross as a fraction of worldwide gross (0.611 is 61.1%).
data.releases[].genre	string	No	Comedy Drama	Genre label shown for the release, for example `Comedy Drama`.
data.releases[].gross_to_date	integer	No	75764672	Gross of the release to date, in US dollars.
data.releases[].gross_to_date_raw	string	No	$75,764,672	Gross to date, as Box Office Mojo displays it, for example `$75,764,672`.
data.releases[].mpa_rating	string	No	PG-13	MPA rating of the release, for example `PG-13`.
data.releases[].opening_share	number	No	0.234	Opening weekend gross as a fraction of total gross (0.234 is 23.4%).
data.releases[].opening_weekend	integer	No	17728313	Opening weekend gross, in US dollars.
data.releases[].opening_weekend_raw	string	No	$17,728,313	Opening weekend gross, as Box Office Mojo displays it, for example `$17,728,313`.
data.releases[].production_budget	integer	No	35000000	Production budget of the release, in US dollars.
data.releases[].production_budget_raw	string	No	$35,000,000	Production budget, as Box Office Mojo displays it, for example `$35,000,000`.
data.releases[].release	string	No	The Intern	Release name as shown on the showdown page.
data.releases[].release_date	string	No	Sep 25, 2015	Release date as shown on the showdown page, for example `Sep 25, 2015`.
data.releases[].release_path	string	No	/release/rl861570561/	Path of the release page on Box Office Mojo, for example `/release/rl861570561/`.
data.releases[].release_url	string	No	https://www.boxofficemojo.com/release/rl861570561/	Full URL of the release page on Box Office Mojo.
data.releases[].running_time	string	No	2 hr 1 min	Running time as shown, for example `2 hr 1 min`.
data.releases[].weekends_at_number_one	integer	No	0	Number of weekends the release ranked first on the domestic weekend chart.
data.releases[].weekends_in_top_ten	integer	No	6	Number of weekends the release ranked in the top ten of the domestic weekend chart.
data.releases[].widest_release	integer	No	3320	Largest number of theaters the release played in at once.
data.releases[].worldwide_gross	integer	No	194764672	Worldwide gross of the release, in US dollars.
data.releases[].worldwide_gross_raw	string	No	$194,764,672	Worldwide gross, as Box Office Mojo displays it, for example `$194,764,672`.
data.showdown_id	string	No	sd943519236	Box Office Mojo showdown id, starting with `sd`.
data.source_url	string	No	https://www.boxofficemojo.com/showdown/sd943519236/	URL of the Box Office Mojo page the data was read from.
data.summary	object	No		Totals and leaders computed across the releases in the showdown.
data.summary.highest_opening_release	string	No	It's Complicated	Release with the highest opening weekend gross in the showdown.
data.summary.highest_opening_weekend	integer	No	22100820	Opening weekend gross of that release, in US dollars.
data.summary.release_count	integer	No	4	Number of releases in the showdown.
data.summary.top_domestic_gross	integer	No	124728738	Domestic gross of the top domestic release, in US dollars.
data.summary.top_domestic_release	string	No	Something's Gotta Give	Release with the highest domestic gross in the showdown.
data.summary.top_worldwide_gross	integer	No	265328738	Worldwide gross of the top worldwide release, in US dollars.
data.summary.top_worldwide_release	string	No	Something's Gotta Give	Release with the highest worldwide gross in the showdown.
data.summary.total_domestic_gross	integer	No	376453634	Combined domestic gross of the releases in the showdown, in US dollars.
data.summary.total_worldwide_gross	integer	No	884396662	Combined worldwide gross of the releases in the showdown, in US dollars.
data.url	string	No	https://www.boxofficemojo.com/showdown/sd943519236/	Full URL of the showdown page on Box Office Mojo.
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/showdown" \
  -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 showdown 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 showdown 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