Docs menu

Box Office Mojo API endpoint

Box Office Mojo title detail API

Returns Box Office Mojo title release-group and market-gross tables from a title page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.titleResponseDoc/boxofficemojo/title

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo title detail API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

id: Box Office Mojo title id, for example tt0499549.
path: title path, for example /title/tt0499549/.
url: absolute https://www.boxofficemojo.com title URL.

Notable response behavior:

data.public_page_derived is true.
release_groups contains rollout-level domestic, international, and worldwide grosses.
market_grosses contains the visible regional market tables when present.
Upstream challenge pages, malformed table data, missing title markers, or parser drift are returned as typed upstream errors.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/title?id=tt0499549
Items in release_groups: 6
Fields filled in every checked item: 8
Fields empty in some or all items: 3

Field	Filled in, of 6 checked	Values in the sample
name	6	“Original Release” and 5 other values
path	6	“/releasegroup/gr3486798341/” and 5 other values
url	6	boxofficemojo.com
rollout	5	“December 16-January 15, 2010” and 4 other values
markets	6	“77 markets” and 5 other values
domestic	3	10,741,486 to 749,766,139, median 24,714,024
domestic_raw	6	“$749,766,139” and 3 other values
international	5	1,281,204 to 1,993,811,448, median 51,298,893
international_raw	6	“$1,993,811,448” and 5 other values
worldwide	6	4,682 to 2,743,577,587, median 44,838,548
worldwide_raw	6	“$2,743,577,587” and 5 other values

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Avatar",
    "title_id": "tt0499549",
    "release_groups": [
      {
        "name": "Original Release",
        "markets": "77 markets",
        "worldwide": 2743577587,
        "worldwide_raw": "$2,743,577,587"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.titleResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.TitleResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.market_grosses	array	No		Lifetime gross per market, grouped by region.
data.market_grosses[].markets	array	No		Gross figures for each market in the region.
data.market_grosses[].markets[].gross_raw	string	No	$181,757,632	Lifetime gross in the market, as Box Office Mojo displays it, for example `$181,757,632`.
data.market_grosses[].markets[].lifetime_gross	integer	No	181757632	Lifetime gross of the title in the market, in US dollars.
data.market_grosses[].markets[].market	string	No	France	Market name, such as a country or territory.
data.market_grosses[].markets[].rank	integer	No	2	Rank shown for the market in the Rank column.
data.market_grosses[].markets[].release_count	integer	No	3	Number of releases of the title in the market.
data.market_grosses[].region	string	No	EMEA	Region name as shown on the title page, for example `EMEA`.
data.path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.release_groups	array	No		Release groups of the title, such as the original release and re-releases.
data.release_groups[].domestic	integer	No	749766139	Domestic gross of the release group, in US dollars.
data.release_groups[].domestic_raw	string	No	$749,766,139	Domestic gross, as Box Office Mojo displays it, for example `$749,766,139`.
data.release_groups[].international	integer	No	1993811448	International gross of the release group, in US dollars.
data.release_groups[].international_raw	string	No	$1,993,811,448	International gross, as Box Office Mojo displays it, for example `$1,993,811,448`.
data.release_groups[].markets	string	No	77 markets	Number of markets the release group played in, for example `77 markets`.
data.release_groups[].name	string	No	Original Release	Release group name, for example `Original Release`.
data.release_groups[].path	string	No	/releasegroup/gr3486798341/	Path of the release group page on Box Office Mojo, for example `/releasegroup/gr3486798341/`.
data.release_groups[].rollout	string	No	December 16-January 15, 2010	Date range over which the release group rolled out, for example `December 16-January 15, 2010`.
data.release_groups[].url	string	No	https://www.boxofficemojo.com/releasegroup/gr3486798341/	Full URL of the release group page on Box Office Mojo.
data.release_groups[].worldwide	integer	No	2743577587	Worldwide gross of the release group, in US dollars.
data.release_groups[].worldwide_raw	string	No	$2,743,577,587	Worldwide gross, as Box Office Mojo displays it, for example `$2,743,577,587`.
data.source_url	string	No	https://www.boxofficemojo.com/title/tt0499549/	URL of the Box Office Mojo page the data was read from.
data.title	string	No	Avatar	Title name as shown on Box Office Mojo.
data.title_id	string	No	tt0499549	Title id of the film, starting with `tt`.
data.url	string	No	https://www.boxofficemojo.com/title/tt0499549/	Full URL of the title 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/title" \
  -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 title detail API

Returns Box Office Mojo title release-group and market-gross tables from a title page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.titleResponseDoc/boxofficemojo/title

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo title detail API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

id: Box Office Mojo title id, for example tt0499549.
path: title path, for example /title/tt0499549/.
url: absolute https://www.boxofficemojo.com title URL.

Notable response behavior:

data.public_page_derived is true.
release_groups contains rollout-level domestic, international, and worldwide grosses.
market_grosses contains the visible regional market tables when present.
Upstream challenge pages, malformed table data, missing title markers, or parser drift are returned as typed upstream errors.

Live monitoring

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

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/title?id=tt0499549
Items in release_groups: 6
Fields filled in every checked item: 8
Fields empty in some or all items: 3

Field	Filled in, of 6 checked	Values in the sample
name	6	“Original Release” and 5 other values
path	6	“/releasegroup/gr3486798341/” and 5 other values
url	6	boxofficemojo.com
rollout	5	“December 16-January 15, 2010” and 4 other values
markets	6	“77 markets” and 5 other values
domestic	3	10,741,486 to 749,766,139, median 24,714,024
domestic_raw	6	“$749,766,139” and 3 other values
international	5	1,281,204 to 1,993,811,448, median 51,298,893
international_raw	6	“$1,993,811,448” and 5 other values
worldwide	6	4,682 to 2,743,577,587, median 44,838,548
worldwide_raw	6	“$2,743,577,587” and 5 other values

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Avatar",
    "title_id": "tt0499549",
    "release_groups": [
      {
        "name": "Original Release",
        "markets": "77 markets",
        "worldwide": 2743577587,
        "worldwide_raw": "$2,743,577,587"
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.titleResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.TitleResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.market_grosses	array	No		Lifetime gross per market, grouped by region.
data.market_grosses[].markets	array	No		Gross figures for each market in the region.
data.market_grosses[].markets[].gross_raw	string	No	$181,757,632	Lifetime gross in the market, as Box Office Mojo displays it, for example `$181,757,632`.
data.market_grosses[].markets[].lifetime_gross	integer	No	181757632	Lifetime gross of the title in the market, in US dollars.
data.market_grosses[].markets[].market	string	No	France	Market name, such as a country or territory.
data.market_grosses[].markets[].rank	integer	No	2	Rank shown for the market in the Rank column.
data.market_grosses[].markets[].release_count	integer	No	3	Number of releases of the title in the market.
data.market_grosses[].region	string	No	EMEA	Region name as shown on the title page, for example `EMEA`.
data.path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.release_groups	array	No		Release groups of the title, such as the original release and re-releases.
data.release_groups[].domestic	integer	No	749766139	Domestic gross of the release group, in US dollars.
data.release_groups[].domestic_raw	string	No	$749,766,139	Domestic gross, as Box Office Mojo displays it, for example `$749,766,139`.
data.release_groups[].international	integer	No	1993811448	International gross of the release group, in US dollars.
data.release_groups[].international_raw	string	No	$1,993,811,448	International gross, as Box Office Mojo displays it, for example `$1,993,811,448`.
data.release_groups[].markets	string	No	77 markets	Number of markets the release group played in, for example `77 markets`.
data.release_groups[].name	string	No	Original Release	Release group name, for example `Original Release`.
data.release_groups[].path	string	No	/releasegroup/gr3486798341/	Path of the release group page on Box Office Mojo, for example `/releasegroup/gr3486798341/`.
data.release_groups[].rollout	string	No	December 16-January 15, 2010	Date range over which the release group rolled out, for example `December 16-January 15, 2010`.
data.release_groups[].url	string	No	https://www.boxofficemojo.com/releasegroup/gr3486798341/	Full URL of the release group page on Box Office Mojo.
data.release_groups[].worldwide	integer	No	2743577587	Worldwide gross of the release group, in US dollars.
data.release_groups[].worldwide_raw	string	No	$2,743,577,587	Worldwide gross, as Box Office Mojo displays it, for example `$2,743,577,587`.
data.source_url	string	No	https://www.boxofficemojo.com/title/tt0499549/	URL of the Box Office Mojo page the data was read from.
data.title	string	No	Avatar	Title name as shown on Box Office Mojo.
data.title_id	string	No	tt0499549	Title id of the film, starting with `tt`.
data.url	string	No	https://www.boxofficemojo.com/title/tt0499549/	Full URL of the title 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/title" \
  -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 title detail 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 title detail 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