Docs menu

Box Office Mojo API endpoint

Box Office Mojo showdowns API

Returns Box Office Mojo's showdowns, which compare groups of movies. Each row has the showdown `name`, `showdown_id`, `path`, `url`, `num_releases`, `total_gross` and the `top_release` with its gross, when Box Office Mojo shows them. Takes no parameters.

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.showdownsResponseDoc/boxofficemojo/showdowns

Endpoint facts

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

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

How this endpoint behaves

Query parameters: none.

Notable response behavior: rows include showdown id, path, absolute url, movie count, and domestic box office totals when present. Unusable upstream responses return an upstream error instead of 200 [].

Live monitoring

Monitored request: GET /boxofficemojo/showdowns
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.94 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/showdowns
Items in results: 594
Fields filled in every checked item: 0
Fields empty in some or all items: 12

Field	Filled in, of 594 checked	Values in the sample
name	500	“12 Years of Nancy Meyers” and 499 other values
showdown_id	500
path	500	“/showdown/sd943519236/” and 499 other values
url	500	boxofficemojo.com
num_releases	500	2 to 11, median 4
total_gross	500	6,144,486 to 4,306,486,620, median 491,126,710
total_gross_raw	500	“$376,453,634” and 498 other values
top_release	500	“Something's Gotta Give” and 341 other values
top_release_path	500	“/release/rl1299219969/” and 341 other values
top_release_url	500	boxofficemojo.com
top_release_gross	500	3,125,613 to 956,891,779, median 172,062,763
top_release_gross_raw	500	“$124,728,738” and 341 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "public_page_derived": true,
    "results": [
      {
        "rank": 1,
        "name": "Marvel Cinematic Universe vs. DC Extended Universe",
        "id": "sd943519236",
        "path": "/showdown/sd943519236/",
        "movies": 37,
        "domestic_gross": 12345678901
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.showdownsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.ShowdownsResponse	No
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		Showdowns listed on Box Office Mojo, one item per showdown.
data.results[].name	string	No	12 Years of Nancy Meyers	Showdown name, for example `12 Years of Nancy Meyers`.
data.results[].num_releases	integer	No	4	Number of releases compared in the showdown.
data.results[].path	string	No	/showdown/sd943519236/	Path of the showdown page on Box Office Mojo, for example `/showdown/sd943519236/`.
data.results[].showdown_id	string	No	sd943519236	Box Office Mojo showdown id, starting with `sd`. Use it with the showdown endpoint.
data.results[].top_release	string	No	Something's Gotta Give	Release with the highest gross in the showdown.
data.results[].top_release_gross	integer	No	124728738	Gross of the top release, in US dollars.
data.results[].top_release_gross_raw	string	No	$124,728,738	Gross of the top release, as Box Office Mojo displays it, for example `$124,728,738`.
data.results[].top_release_path	string	No	/release/rl1299219969/	Path of the top release's page on Box Office Mojo.
data.results[].top_release_url	string	No	https://www.boxofficemojo.com/release/rl1299219969/	Full URL of the top release's page on Box Office Mojo.
data.results[].total_gross	integer	No	376453634	Combined gross of all releases in the showdown, in US dollars.
data.results[].total_gross_raw	string	No	$376,453,634	Combined gross of the showdown, as Box Office Mojo displays it, for example `$376,453,634`.
data.results[].url	string	No	https://www.boxofficemojo.com/showdown/sd943519236/	Full URL of the showdown page on Box Office Mojo.
data.source_url	string	No	https://www.boxofficemojo.com/showdown/	URL of the Box Office Mojo page the data was read from.
msg	string	No	OK

Failure responses

Status	Description	Schema
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/showdowns" \
  -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 showdowns API

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.showdownsResponseDoc/boxofficemojo/showdowns

Endpoint facts

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

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

How this endpoint behaves

Query parameters: none.

Live monitoring

Monitored request: GET /boxofficemojo/showdowns
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.94 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/showdowns
Items in results: 594
Fields filled in every checked item: 0
Fields empty in some or all items: 12

Field	Filled in, of 594 checked	Values in the sample
name	500	“12 Years of Nancy Meyers” and 499 other values
showdown_id	500
path	500	“/showdown/sd943519236/” and 499 other values
url	500	boxofficemojo.com
num_releases	500	2 to 11, median 4
total_gross	500	6,144,486 to 4,306,486,620, median 491,126,710
total_gross_raw	500	“$376,453,634” and 498 other values
top_release	500	“Something's Gotta Give” and 341 other values
top_release_path	500	“/release/rl1299219969/” and 341 other values
top_release_url	500	boxofficemojo.com
top_release_gross	500	3,125,613 to 956,891,779, median 172,062,763
top_release_gross_raw	500	“$124,728,738” and 341 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "public_page_derived": true,
    "results": [
      {
        "rank": 1,
        "name": "Marvel Cinematic Universe vs. DC Extended Universe",
        "id": "sd943519236",
        "path": "/showdown/sd943519236/",
        "movies": 37,
        "domestic_gross": 12345678901
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.showdownsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.ShowdownsResponse	No
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		Showdowns listed on Box Office Mojo, one item per showdown.
data.results[].name	string	No	12 Years of Nancy Meyers	Showdown name, for example `12 Years of Nancy Meyers`.
data.results[].num_releases	integer	No	4	Number of releases compared in the showdown.
data.results[].path	string	No	/showdown/sd943519236/	Path of the showdown page on Box Office Mojo, for example `/showdown/sd943519236/`.
data.results[].showdown_id	string	No	sd943519236	Box Office Mojo showdown id, starting with `sd`. Use it with the showdown endpoint.
data.results[].top_release	string	No	Something's Gotta Give	Release with the highest gross in the showdown.
data.results[].top_release_gross	integer	No	124728738	Gross of the top release, in US dollars.
data.results[].top_release_gross_raw	string	No	$124,728,738	Gross of the top release, as Box Office Mojo displays it, for example `$124,728,738`.
data.results[].top_release_path	string	No	/release/rl1299219969/	Path of the top release's page on Box Office Mojo.
data.results[].top_release_url	string	No	https://www.boxofficemojo.com/release/rl1299219969/	Full URL of the top release's page on Box Office Mojo.
data.results[].total_gross	integer	No	376453634	Combined gross of all releases in the showdown, in US dollars.
data.results[].total_gross_raw	string	No	$376,453,634	Combined gross of the showdown, as Box Office Mojo displays it, for example `$376,453,634`.
data.results[].url	string	No	https://www.boxofficemojo.com/showdown/sd943519236/	Full URL of the showdown page on Box Office Mojo.
data.source_url	string	No	https://www.boxofficemojo.com/showdown/	URL of the Box Office Mojo page the data was read from.
msg	string	No	OK

Failure responses

Status	Description	Schema
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/showdowns" \
  -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 showdowns 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 showdowns 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