Docs menu

Box Office Mojo API endpoint

Box Office Mojo domestic yearly API

Returns the Box Office Mojo domestic box office chart for one year. `year` is required and runs from 1977 to 2100. Each row has `rank`, `release`, `release_date`, `distributor`, `theaters`, `gross`, `total_gross` and `new_this_year`, each gross also with its displayed text in a `_raw` field.

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.domesticYearResponseDoc/boxofficemojo/year/domestic

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo domestic yearly API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

year - Required domestic box office year, from 1977 through 2100.

Notable response behavior:

The response includes the requested year, grosses_option, source URL, fetch time, and domestic yearly rows.
Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload.

Live monitoring

Monitored request: GET /boxofficemojo/year/domestic?year=2025
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.29 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/year/domestic?year=2025
Items in results: 200
Fields filled in every checked item: 12

Field	Filled in, of 200 checked	Values in the sample
rank	200	1 to 200, median 100
release	200	“A Minecraft Movie” and 199 other values
release_path	200	“/release/rl746096129/” and 199 other values
release_url	200	boxofficemojo.com
gross	200	1,750,000 to 423,949,195, median 15,153,346
gross_raw	200	“$423,949,195” and 199 other values
theaters	200	140 to 4,410, median 2,375
total_gross	200	1,750,000 to 474,983,975, median 16,252,948
total_gross_raw	200	“$424,087,780” and 199 other values
release_date	200	“Apr 4” and 69 other values
distributor	200	“Warner Bros.” and 40 other values
new_this_year	200	true in 0 of 200

Request parameters

Parameter	Type	Required	Default	Description	Example
year	integer	Yes		Domestic box office year, from 1977 through 2100	2025
x-api-key (header)	string	Yes		API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "year": 2025,
    "grosses_option": "calendar_grosses",
    "results": [
      {
        "rank": 1,
        "release": "Lilo & Stitch",
        "gross_raw": "$423,778,855"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.domesticYearResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.DomesticYearResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.grosses_option	string	No	calendar_grosses	Grosses view of the yearly chart; always `calendar_grosses`, which counts gross earned within the calendar year.
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 yearly chart, one per release, in chart order.
data.results[].distributor	string	No	Walt Disney Studios Motion Pictures	Studio or distributor handling the release.
data.results[].gross	integer	No	423778855	Domestic gross earned within the calendar year, in US dollars.
data.results[].gross_raw	string	No	$423,778,855	Domestic gross within the year, as Box Office Mojo displays it, for example `$423,778,855`.
data.results[].new_this_year	boolean	No	false	`true` when Box Office Mojo flags the row's yearly figures as estimates.
data.results[].rank	integer	No	1	Position on the yearly chart.
data.results[].release	string	No	Lilo & Stitch	Release name as shown on the yearly chart.
data.results[].release_date	string	No	May 23	Release date as shown on the chart, for example `May 23`.
data.results[].release_path	string	No	/release/rl4045406209/	Path of the release page on Box Office Mojo, for example `/release/rl4045406209/`.
data.results[].release_url	string	No	https://www.boxofficemojo.com/release/rl4045406209/	Full URL of the release page on Box Office Mojo.
data.results[].theaters	integer	No	4410	Number of theaters showing the release.
data.results[].total_gross	integer	No	423778855	Domestic gross of the release to date, in US dollars.
data.results[].total_gross_raw	string	No	$423,778,855	Domestic gross to date, as Box Office Mojo displays it, for example `$423,778,855`.
data.source_url	string	No	https://www.boxofficemojo.com/year/2025/?grossesOption=calendarGrosses	URL of the Box Office Mojo page the data was read from.
data.year	integer	No	2025	Calendar year of the chart.
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/year/domestic?year=2025" \
  -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 domestic yearly API

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.domesticYearResponseDoc/boxofficemojo/year/domestic

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo domestic yearly API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

year - Required domestic box office year, from 1977 through 2100.

Notable response behavior:

The response includes the requested year, grosses_option, source URL, fetch time, and domestic yearly rows.
Parser drift, challenge pages, or malformed upstream tables return an upstream error instead of an empty success payload.

Live monitoring

Monitored request: GET /boxofficemojo/year/domestic?year=2025
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.29 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/year/domestic?year=2025
Items in results: 200
Fields filled in every checked item: 12

Field	Filled in, of 200 checked	Values in the sample
rank	200	1 to 200, median 100
release	200	“A Minecraft Movie” and 199 other values
release_path	200	“/release/rl746096129/” and 199 other values
release_url	200	boxofficemojo.com
gross	200	1,750,000 to 423,949,195, median 15,153,346
gross_raw	200	“$423,949,195” and 199 other values
theaters	200	140 to 4,410, median 2,375
total_gross	200	1,750,000 to 474,983,975, median 16,252,948
total_gross_raw	200	“$424,087,780” and 199 other values
release_date	200	“Apr 4” and 69 other values
distributor	200	“Warner Bros.” and 40 other values
new_this_year	200	true in 0 of 200

Request parameters

Parameter	Type	Required	Default	Description	Example
year	integer	Yes		Domestic box office year, from 1977 through 2100	2025
x-api-key (header)	string	Yes		API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "year": 2025,
    "grosses_option": "calendar_grosses",
    "results": [
      {
        "rank": 1,
        "release": "Lilo & Stitch",
        "gross_raw": "$423,778,855"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.domesticYearResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.DomesticYearResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.grosses_option	string	No	calendar_grosses	Grosses view of the yearly chart; always `calendar_grosses`, which counts gross earned within the calendar year.
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 yearly chart, one per release, in chart order.
data.results[].distributor	string	No	Walt Disney Studios Motion Pictures	Studio or distributor handling the release.
data.results[].gross	integer	No	423778855	Domestic gross earned within the calendar year, in US dollars.
data.results[].gross_raw	string	No	$423,778,855	Domestic gross within the year, as Box Office Mojo displays it, for example `$423,778,855`.
data.results[].new_this_year	boolean	No	false	`true` when Box Office Mojo flags the row's yearly figures as estimates.
data.results[].rank	integer	No	1	Position on the yearly chart.
data.results[].release	string	No	Lilo & Stitch	Release name as shown on the yearly chart.
data.results[].release_date	string	No	May 23	Release date as shown on the chart, for example `May 23`.
data.results[].release_path	string	No	/release/rl4045406209/	Path of the release page on Box Office Mojo, for example `/release/rl4045406209/`.
data.results[].release_url	string	No	https://www.boxofficemojo.com/release/rl4045406209/	Full URL of the release page on Box Office Mojo.
data.results[].theaters	integer	No	4410	Number of theaters showing the release.
data.results[].total_gross	integer	No	423778855	Domestic gross of the release to date, in US dollars.
data.results[].total_gross_raw	string	No	$423,778,855	Domestic gross to date, as Box Office Mojo displays it, for example `$423,778,855`.
data.source_url	string	No	https://www.boxofficemojo.com/year/2025/?grossesOption=calendarGrosses	URL of the Box Office Mojo page the data was read from.
data.year	integer	No	2025	Calendar year of the chart.
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/year/domestic?year=2025" \
  -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 domestic yearly 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 domestic yearly 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