Docs menu

Box Office Mojo API endpoint

Box Office Mojo lifetime gross chart API

Returns one page of Box Office Mojo's lifetime gross chart of movies. `area` is `worldwide` (default) or `domestic`, and `offset` pages in steps of 200 from 0 to 800. Each row has `rank`, `title`, `title_id`, `year` and `lifetime_gross` as an integer, with the displayed text in `lifetime_gross_raw`.

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.lifetimeGrossesResponseDoc/boxofficemojo/lifetime-grosses

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo lifetime gross chart API in Playground Box Office Mojo API documentation

How this endpoint behaves

Returns movie rows from Box Office Mojo's public lifetime gross chart.

Query parameters:

area: chart area. Allowed values: worldwide, domestic. Defaults to worldwide.
offset: chart page offset. Allowed values: 0, 200, 400, 600, 800. Defaults to 0.

Notable response behavior:

data.public_page_derived is true.
lifetime_gross is a parsed integer when the page exposes a money value; lifetime_gross_raw keeps the visible upstream text.
Upstream challenge pages, malformed table data, or parser drift are returned as typed upstream errors.

Live monitoring

Monitored request: GET /boxofficemojo/lifetime-grosses?area=worldwide&offset=0
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.20 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/lifetime-grosses?area=worldwide&offset=0
Items in results: 200
Fields filled in every checked item: 8

Field	Filled in, of 200 checked	Values in the sample
rank	200	1 to 200, median 100
title	200	“Avengers: Endgame” and 198 other values
title_id	200
title_path	200	“/title/tt4154796/” and 199 other values
title_url	200	boxofficemojo.com
lifetime_gross	200	622,674,139 to 2,937,427,350, median 869,146,189
lifetime_gross_raw	200	“$2,937,427,350” and 199 other values
year	200	1,977 to 2,026, median 2,015

Request parameters

Parameter	Type	Required	Description	Example
area	string	No	Chart area. Allowed values: worldwide, domestic Allowed values: worldwide, domestic.	worldwide
offset	integer	No	Chart page offset. Allowed values: 0, 200, 400, 600, 800	0
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/lifetime-grosses?area=worldwide" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "area": "worldwide",
    "offset": 0,
    "range": "1-200 of 1,000",
    "results": [
      {
        "rank": 1,
        "title": "Avatar",
        "title_id": "tt0499549",
        "lifetime_gross": 2923710708,
        "lifetime_gross_raw": "$2,923,710,708",
        "year": 2009
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.lifetimeGrossesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.LifetimeGrossesResponse	No
data.area	string	No	worldwide	Chart area that was returned: `worldwide` or `domestic`.
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.offset	integer	No	0	Number of rows skipped before this page, in steps of 200.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.range	string	No	1-200 of 1,000	Range of ranks shown and the chart size, for example `1-200 of 1,000`.
data.results	array	No		Rows of the lifetime gross chart, one per title, in chart order.
data.results[].lifetime_gross	integer	No	2923710708	Lifetime gross of the title, in US dollars.
data.results[].lifetime_gross_raw	string	No	$2,923,710,708	Lifetime gross, as Box Office Mojo displays it, for example `$2,923,710,708`.
data.results[].rank	integer	No	1	Position on the lifetime gross chart.
data.results[].title	string	No	Avatar	Title name as shown on the chart.
data.results[].title_id	string	No	tt0499549	Title id of the film, starting with `tt`. Use it with the title endpoint.
data.results[].title_path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.results[].title_url	string	No	https://www.boxofficemojo.com/title/tt0499549/	Full URL of the title page on Box Office Mojo.
data.results[].year	integer	No	2009	Release year of the title.
data.source_url	string	No	https://www.boxofficemojo.com/chart/top_lifetime_gross/?area=XWW	URL of the Box Office Mojo page the data was read from.
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/lifetime-grosses?area=worldwide" \
  -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 lifetime gross chart API

GETapiKey2 credits/requestBox Office Mojoboxofficemojo.lifetimeGrossesResponseDoc/boxofficemojo/lifetime-grosses

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo lifetime gross chart API in Playground Box Office Mojo API documentation

How this endpoint behaves

Returns movie rows from Box Office Mojo's public lifetime gross chart.

Query parameters:

area: chart area. Allowed values: worldwide, domestic. Defaults to worldwide.
offset: chart page offset. Allowed values: 0, 200, 400, 600, 800. Defaults to 0.

Notable response behavior:

data.public_page_derived is true.
lifetime_gross is a parsed integer when the page exposes a money value; lifetime_gross_raw keeps the visible upstream text.
Upstream challenge pages, malformed table data, or parser drift are returned as typed upstream errors.

Live monitoring

Monitored request: GET /boxofficemojo/lifetime-grosses?area=worldwide&offset=0
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.20 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/lifetime-grosses?area=worldwide&offset=0
Items in results: 200
Fields filled in every checked item: 8

Field	Filled in, of 200 checked	Values in the sample
rank	200	1 to 200, median 100
title	200	“Avengers: Endgame” and 198 other values
title_id	200
title_path	200	“/title/tt4154796/” and 199 other values
title_url	200	boxofficemojo.com
lifetime_gross	200	622,674,139 to 2,937,427,350, median 869,146,189
lifetime_gross_raw	200	“$2,937,427,350” and 199 other values
year	200	1,977 to 2,026, median 2,015

Request parameters

Parameter	Type	Required	Description	Example
area	string	No	Chart area. Allowed values: worldwide, domestic Allowed values: worldwide, domestic.	worldwide
offset	integer	No	Chart page offset. Allowed values: 0, 200, 400, 600, 800	0
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/boxofficemojo/lifetime-grosses?area=worldwide" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "area": "worldwide",
    "offset": 0,
    "range": "1-200 of 1,000",
    "results": [
      {
        "rank": 1,
        "title": "Avatar",
        "title_id": "tt0499549",
        "lifetime_gross": 2923710708,
        "lifetime_gross_raw": "$2,923,710,708",
        "year": 2009
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.lifetimeGrossesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.LifetimeGrossesResponse	No
data.area	string	No	worldwide	Chart area that was returned: `worldwide` or `domestic`.
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.offset	integer	No	0	Number of rows skipped before this page, in steps of 200.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.range	string	No	1-200 of 1,000	Range of ranks shown and the chart size, for example `1-200 of 1,000`.
data.results	array	No		Rows of the lifetime gross chart, one per title, in chart order.
data.results[].lifetime_gross	integer	No	2923710708	Lifetime gross of the title, in US dollars.
data.results[].lifetime_gross_raw	string	No	$2,923,710,708	Lifetime gross, as Box Office Mojo displays it, for example `$2,923,710,708`.
data.results[].rank	integer	No	1	Position on the lifetime gross chart.
data.results[].title	string	No	Avatar	Title name as shown on the chart.
data.results[].title_id	string	No	tt0499549	Title id of the film, starting with `tt`. Use it with the title endpoint.
data.results[].title_path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.results[].title_url	string	No	https://www.boxofficemojo.com/title/tt0499549/	Full URL of the title page on Box Office Mojo.
data.results[].year	integer	No	2009	Release year of the title.
data.source_url	string	No	https://www.boxofficemojo.com/chart/top_lifetime_gross/?area=XWW	URL of the Box Office Mojo page the data was read from.
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/lifetime-grosses?area=worldwide" \
  -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 lifetime gross chart 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 lifetime gross chart 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