Docs menu

Box Office Mojo API endpoint

Box Office Mojo weekend distributors API

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

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.weekendDistributorResponseDoc/boxofficemojo/weekend/domestic/by-distributor

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo weekend distributors API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

year - Required domestic weekend year, from 1982 through 2100.
week - Required weekend number, from 1 through 53.

Notable response behavior:

The response includes the requested year/week, date range when present, source URL, fetch time, and distributor rows.
Empty upstream weekend 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/weekend/domestic/by-distributor?week=52&year=2025
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.32 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/weekend/domestic/by-distributor?week=52&year=2025
Items in results: 25
Fields filled in every checked item: 13
Fields empty in some or all items: 2

Field	Filled in, of 25 checked	Values in the sample
rank	25	1 to 26, median 13
last_week_rank	25	1 to 27, median 13
total_gross	25	217 to 63,276,213, median 108,391
total_gross_raw	25	“$63,276,213” and 24 other values
change_percent	24	-0.97 to 9.89, median -0.24
share	11	0 to 0.37, median 0.07
releases	25	1 to 4, median 2
top_release	25	“Avatar: Fire and Ash” and 24 other values
top_release_path	25	“/release/rl3389031937/” and 24 other values
top_release_url	25	boxofficemojo.com
weekend_gross	25	136 to 63,087,667, median 74,796
weekend_gross_raw	25	“$63,087,667” and 24 other values
gross_share	25	0.51 to 1, median 1
week_in_release	25	1 to 101, median 4
distributor	25	“20th Century Studios” and 24 other values

Request parameters

Parameter	Type	Required	Description	Example
year	integer	Yes	Domestic weekend year, from 1982 through 2100	2025
week	integer	Yes	Weekend number, 1 through 53	52
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "year": 2025,
    "week": 52,
    "results": [
      {
        "rank": 1,
        "top_release": "Avatar: Fire and Ash",
        "total_gross_raw": "$86,754,431"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.weekendDistributorResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	boxofficemojo.WeekendDistributorResponse	No
data.date_range	string	No	December 26-28, 2025
data.fetched_at	string	No	2026-06-07T14:46:16Z
data.public_page_derived	boolean	No	true
data.results	array	No
data.results[].change_percent	number	No	-0.315
data.results[].distributor	string	No	20th Century Studios
data.results[].gross_share	number	No	0.727
data.results[].last_week_rank	integer	No	1
data.results[].rank	integer	No	1
data.results[].releases	integer	No	7
data.results[].share	number	No	0.521
data.results[].top_release	string	No	Avatar: Fire and Ash
data.results[].top_release_path	string	No	/release/rl3389031937/
data.results[].top_release_url	string	No	https://www.boxofficemojo.com/release/rl3389031937/
data.results[].total_gross	integer	No	86754431
data.results[].total_gross_raw	string	No	$86,754,431
data.results[].week_in_release	integer	No	2
data.results[].weekend_gross	integer	No	63087667
data.results[].weekend_gross_raw	string	No	$63,087,667
data.source_url	string	No	https://www.boxofficemojo.com/weekend/2025W52/by-distributor/
data.week	integer	No	52
data.year	integer	No	2025
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/weekend/domestic/by-distributor?year=2025&week=52" \
  -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 weekend distributors API

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

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.weekendDistributorResponseDoc/boxofficemojo/weekend/domestic/by-distributor

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo weekend distributors API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

year - Required domestic weekend year, from 1982 through 2100.
week - Required weekend number, from 1 through 53.

Notable response behavior:

The response includes the requested year/week, date range when present, source URL, fetch time, and distributor rows.
Empty upstream weekend 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/weekend/domestic/by-distributor?week=52&year=2025
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.32 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/weekend/domestic/by-distributor?week=52&year=2025
Items in results: 25
Fields filled in every checked item: 13
Fields empty in some or all items: 2

Field	Filled in, of 25 checked	Values in the sample
rank	25	1 to 26, median 13
last_week_rank	25	1 to 27, median 13
total_gross	25	217 to 63,276,213, median 108,391
total_gross_raw	25	“$63,276,213” and 24 other values
change_percent	24	-0.97 to 9.89, median -0.24
share	11	0 to 0.37, median 0.07
releases	25	1 to 4, median 2
top_release	25	“Avatar: Fire and Ash” and 24 other values
top_release_path	25	“/release/rl3389031937/” and 24 other values
top_release_url	25	boxofficemojo.com
weekend_gross	25	136 to 63,087,667, median 74,796
weekend_gross_raw	25	“$63,087,667” and 24 other values
gross_share	25	0.51 to 1, median 1
week_in_release	25	1 to 101, median 4
distributor	25	“20th Century Studios” and 24 other values

Request parameters

Parameter	Type	Required	Description	Example
year	integer	Yes	Domestic weekend year, from 1982 through 2100	2025
week	integer	Yes	Weekend number, 1 through 53	52
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "year": 2025,
    "week": 52,
    "results": [
      {
        "rank": 1,
        "top_release": "Avatar: Fire and Ash",
        "total_gross_raw": "$86,754,431"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.weekendDistributorResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	boxofficemojo.WeekendDistributorResponse	No
data.date_range	string	No	December 26-28, 2025
data.fetched_at	string	No	2026-06-07T14:46:16Z
data.public_page_derived	boolean	No	true
data.results	array	No
data.results[].change_percent	number	No	-0.315
data.results[].distributor	string	No	20th Century Studios
data.results[].gross_share	number	No	0.727
data.results[].last_week_rank	integer	No	1
data.results[].rank	integer	No	1
data.results[].releases	integer	No	7
data.results[].share	number	No	0.521
data.results[].top_release	string	No	Avatar: Fire and Ash
data.results[].top_release_path	string	No	/release/rl3389031937/
data.results[].top_release_url	string	No	https://www.boxofficemojo.com/release/rl3389031937/
data.results[].total_gross	integer	No	86754431
data.results[].total_gross_raw	string	No	$86,754,431
data.results[].week_in_release	integer	No	2
data.results[].weekend_gross	integer	No	63087667
data.results[].weekend_gross_raw	string	No	$63,087,667
data.source_url	string	No	https://www.boxofficemojo.com/weekend/2025W52/by-distributor/
data.week	integer	No	52
data.year	integer	No	2025
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/weekend/domestic/by-distributor?year=2025&week=52" \
  -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 weekend distributors 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 weekend distributors 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