Docs menu

Box Office Mojo API endpoint

Box Office Mojo release group detail API

Returns market release rows grouped by region from a Box Office Mojo release-group page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.releaseGroupResponseDoc/boxofficemojo/release-group

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo release group detail API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

id - Optional Box Office Mojo release-group id, such as gr3486798341.
path - Optional Box Office Mojo release-group path, such as /releasegroup/gr3486798341/.
url - Optional absolute https://www.boxofficemojo.com release-group URL.

Notable response behavior:

The response includes title, release-group id, source URL, region tables, and market rows with release date, opening, and gross values when present.
Parser drift, challenge pages, malformed upstream tables, or missing required release-group markers return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/release-group?id=gr3486798341
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.93 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/release-group?id=gr3486798341
Items in regions: 5
Fields filled in every checked item: 2

Field	Filled in, of 5 checked	Values in the sample
region	5	“Domestic” and 4 other values
markets	5	median 15 entries

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Avatar",
    "release_group_id": "gr3486798341",
    "regions": [
      {
        "region": "Domestic",
        "markets": [
          {
            "market": "Domestic",
            "release_date": "Dec 18, 2009",
            "opening_raw": "$77,025,481",
            "gross_raw": "$749,766,139"
          }
        ]
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.releaseGroupResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.ReleaseGroupResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.path	string	No	/releasegroup/gr3486798341/	Path of the release group page on Box Office Mojo, for example `/releasegroup/gr3486798341/`.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.regions	array	No		Market tables grouped by region.
data.regions[].markets	array	No		Release figures for each market in the region.
data.regions[].markets[].gross	integer	No	174376309	Gross in the market, in US dollars.
data.regions[].markets[].gross_raw	string	No	$174,376,309	Gross in the market, as Box Office Mojo displays it, for example `$174,376,309`.
data.regions[].markets[].market	string	No	France	Market name, such as a country or territory.
data.regions[].markets[].opening	integer	No	17436397	Opening gross in the market, in US dollars.
data.regions[].markets[].opening_raw	string	No	$17,436,397	Opening gross in the market, as Box Office Mojo displays it, for example `$17,436,397`.
data.regions[].markets[].release_date	string	No	Dec 16, 2009	Release date in the market, for example `Dec 16, 2009`.
data.regions[].markets[].release_path	string	No	/release/rl1848870401/	Path of the market's release page on Box Office Mojo, for example `/release/rl1848870401/`.
data.regions[].markets[].release_url	string	No	https://www.boxofficemojo.com/release/rl1848870401/	Full URL of the market's release page on Box Office Mojo.
data.regions[].region	string	No	Europe, Middle East, and Africa	Region name as shown on the release group page, for example `Europe, Middle East, and Africa`.
data.release_group_id	string	No	gr3486798341	Box Office Mojo release group id, starting with `gr`.
data.source_url	string	No	https://www.boxofficemojo.com/releasegroup/gr3486798341/	URL of the Box Office Mojo page the data was read from.
data.title	string	No	Avatar	Title name the release group belongs to.
data.title_id	string	No	tt0499549	Title id of the film, starting with `tt`. Use it with the title endpoint.
data.title_path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.title_url	string	No	https://www.boxofficemojo.com/title/tt0499549/	Full URL of the title page on Box Office Mojo.
data.url	string	No	https://www.boxofficemojo.com/releasegroup/gr3486798341/	Full URL of the release group 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/release-group" \
  -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 release group detail API

Returns market release rows grouped by region from a Box Office Mojo release-group page. Pass exactly one of `id`, `path`, or `url`.

GETapiKey3 credits/requestBox Office Mojoboxofficemojo.releaseGroupResponseDoc/boxofficemojo/release-group

Endpoint facts

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

Box Office Mojo Scraper API Try Box Office Mojo release group detail API in Playground Box Office Mojo API documentation

How this endpoint behaves

Query parameters:

id - Optional Box Office Mojo release-group id, such as gr3486798341.
path - Optional Box Office Mojo release-group path, such as /releasegroup/gr3486798341/.
url - Optional absolute https://www.boxofficemojo.com release-group URL.

Notable response behavior:

The response includes title, release-group id, source URL, region tables, and market rows with release date, opening, and gross values when present.
Parser drift, challenge pages, malformed upstream tables, or missing required release-group markers return an upstream error.

Live monitoring

Monitored request: GET /boxofficemojo/release-group?id=gr3486798341
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.93 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /boxofficemojo/release-group?id=gr3486798341
Items in regions: 5
Fields filled in every checked item: 2

Field	Filled in, of 5 checked	Values in the sample
region	5	“Domestic” and 4 other values
markets	5	median 15 entries

Request parameters

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

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "title": "Avatar",
    "release_group_id": "gr3486798341",
    "regions": [
      {
        "region": "Domestic",
        "markets": [
          {
            "market": "Domestic",
            "release_date": "Dec 18, 2009",
            "opening_raw": "$77,025,481",
            "gross_raw": "$749,766,139"
          }
        ]
      }
    ],
    "public_page_derived": true
  }
}

Request schema

No body schema

Response schema

#/definitions/boxofficemojo.releaseGroupResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	boxofficemojo.ReleaseGroupResponse	No
data.fetched_at	string	No	2026-06-07T14:46:16Z	Time the data was fetched, in UTC (RFC 3339).
data.path	string	No	/releasegroup/gr3486798341/	Path of the release group page on Box Office Mojo, for example `/releasegroup/gr3486798341/`.
data.public_page_derived	boolean	No	true	Always `true`; the values come from Box Office Mojo's public pages.
data.regions	array	No		Market tables grouped by region.
data.regions[].markets	array	No		Release figures for each market in the region.
data.regions[].markets[].gross	integer	No	174376309	Gross in the market, in US dollars.
data.regions[].markets[].gross_raw	string	No	$174,376,309	Gross in the market, as Box Office Mojo displays it, for example `$174,376,309`.
data.regions[].markets[].market	string	No	France	Market name, such as a country or territory.
data.regions[].markets[].opening	integer	No	17436397	Opening gross in the market, in US dollars.
data.regions[].markets[].opening_raw	string	No	$17,436,397	Opening gross in the market, as Box Office Mojo displays it, for example `$17,436,397`.
data.regions[].markets[].release_date	string	No	Dec 16, 2009	Release date in the market, for example `Dec 16, 2009`.
data.regions[].markets[].release_path	string	No	/release/rl1848870401/	Path of the market's release page on Box Office Mojo, for example `/release/rl1848870401/`.
data.regions[].markets[].release_url	string	No	https://www.boxofficemojo.com/release/rl1848870401/	Full URL of the market's release page on Box Office Mojo.
data.regions[].region	string	No	Europe, Middle East, and Africa	Region name as shown on the release group page, for example `Europe, Middle East, and Africa`.
data.release_group_id	string	No	gr3486798341	Box Office Mojo release group id, starting with `gr`.
data.source_url	string	No	https://www.boxofficemojo.com/releasegroup/gr3486798341/	URL of the Box Office Mojo page the data was read from.
data.title	string	No	Avatar	Title name the release group belongs to.
data.title_id	string	No	tt0499549	Title id of the film, starting with `tt`. Use it with the title endpoint.
data.title_path	string	No	/title/tt0499549/	Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
data.title_url	string	No	https://www.boxofficemojo.com/title/tt0499549/	Full URL of the title page on Box Office Mojo.
data.url	string	No	https://www.boxofficemojo.com/releasegroup/gr3486798341/	Full URL of the release group 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/release-group" \
  -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 release group 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 release group 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