Docs menu

IMDb API endpoint

IMDb title box office summary API

Returns a title's public box-office summary: lifetime gross by market (domestic, international, worldwide), the domestic opening weekend, and the production budget. IMDb reports each figure independently, so a real title with no box office data (most TV series, many non-theatrical titles) returns `has_box_office: false` with every figure omitted rather than an error. Pass exactly one of `id` or `url`.

GETapiKey2 credits/requestIMDbimdb.titleBoxOfficeResponseDoc/imdb/title/box-office

Endpoint facts

Method: GET
API path: /imdb/title/box-office
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: IMDb
Response schema: #/definitions/imdb.titleBoxOfficeResponseDoc

IMDb Scraper API Try IMDb title box office summary API in Playground IMDb API documentation

How this endpoint behaves

Query parameters:

id: IMDb title ID, for example tt0111161.
url: absolute IMDb title URL, for example https://www.imdb.com/title/tt0111161/.

Notable response behavior:

IMDb reports each figure independently. A real title with no reported box office data — most TV series and many non-theatrical titles — returns has_box_office: false with production_budget, opening_weekend, and every lifetime_gross field omitted, not an error.
lifetime_gross.domestic/.international/.worldwide are each an independent {amount, currency} figure and may be present or absent on their own.
opening_weekend covers the domestic market only; IMDb was verified to return no data for international or worldwide opening-weekend queries, so this API does not expose them.
A well-formed but unresolvable title ID returns a not-found error.
If IMDb changes the shape of this data, the endpoint fails closed with an upstream parser-drift error.

Live monitoring

Monitored request: GET /imdb/title/box-office?id=tt0111161
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.33 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/title/box-office?id=tt0111161
Fields returned with a value: 13

Field	In the sample	Value in the sample
id	Has a value
title	Has a value	“The Shawshank Redemption”
url	Has a value	imdb.com
has_box_office	Has a value	true
production_budget.amount	Has a value	25,000,000
production_budget.currency	Has a value	“USD”
opening_weekend.gross	Has a value
opening_weekend.theater_count	Has a value	33
opening_weekend.weekend_start_date	Has a value	1994-09-23
opening_weekend.weekend_end_date	Has a value	1994-09-25
lifetime_gross.domestic	Has a value
lifetime_gross.international	Has a value
lifetime_gross.worldwide	Has a value

Request parameters

Parameter	Type	Required	Description	Example
id	string	No	IMDb title id	tt0111161
url	string	No	Absolute https://www.imdb.com/title/<id>/ URL	https://www.imdb.com/title/tt0111161/
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "tt0111161",
    "title": "The Shawshank Redemption",
    "url": "https://www.imdb.com/title/tt0111161/",
    "has_box_office": true,
    "production_budget": {
      "amount": 25000000,
      "currency": "USD"
    },
    "opening_weekend": {
      "gross": {
        "amount": 727327,
        "currency": "USD"
      },
      "theater_count": 33,
      "weekend_start_date": "1994-09-23",
      "weekend_end_date": "1994-09-25"
    },
    "lifetime_gross": {
      "domestic": {
        "amount": 28767189,
        "currency": "USD"
      },
      "international": {
        "amount": 628529,
        "currency": "USD"
      },
      "worldwide": {
        "amount": 29425268,
        "currency": "USD"
      }
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.titleBoxOfficeResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	imdb.TitleBoxOfficeResponse	No
data.fetched_at	string	No	2026-09-17T14:46:16Z
data.has_box_office	boolean	No	true
data.id	string	No	tt0111161
data.lifetime_gross	imdb.LifetimeGross	No
data.lifetime_gross.domestic	imdb.Money	No
data.lifetime_gross.domestic.amount	integer	No	28767189
data.lifetime_gross.domestic.currency	string	No	USD
data.lifetime_gross.international	imdb.Money	No
data.lifetime_gross.international.amount	integer	No	28767189
data.lifetime_gross.international.currency	string	No	USD
data.lifetime_gross.worldwide	imdb.Money	No
data.lifetime_gross.worldwide.amount	integer	No	28767189
data.lifetime_gross.worldwide.currency	string	No	USD
data.opening_weekend	imdb.OpeningWeekend	No
data.opening_weekend.gross	imdb.Money	No
data.opening_weekend.gross.amount	integer	No	28767189
data.opening_weekend.gross.currency	string	No	USD
data.opening_weekend.theater_count	integer	No	3
data.opening_weekend.weekend_end_date	string	No	1994-09-25
data.opening_weekend.weekend_start_date	string	No	1994-09-23
data.production_budget	imdb.Money	No
data.production_budget.amount	integer	No	28767189
data.production_budget.currency	string	No	USD
data.source_url	string	No	https://www.imdb.com/title/tt0111161/
data.title	string	No	The Shawshank Redemption
data.url	string	No	https://www.imdb.com/title/tt0111161/
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/imdb/title/box-office" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More IMDb endpoint docs IMDb Scraper API IMDb title charts API documentation IMDb image types API documentation IMDb name detail API documentation IMDb name awards API documentation IMDb name credits API documentation IMDb name images API documentation

Open in Playground Back to group

Docs menu

IMDb API endpoint

IMDb title box office summary API

GETapiKey2 credits/requestIMDbimdb.titleBoxOfficeResponseDoc/imdb/title/box-office

Endpoint facts

Method: GET
API path: /imdb/title/box-office
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: IMDb
Response schema: #/definitions/imdb.titleBoxOfficeResponseDoc

IMDb Scraper API Try IMDb title box office summary API in Playground IMDb API documentation

How this endpoint behaves

Query parameters:

id: IMDb title ID, for example tt0111161.
url: absolute IMDb title URL, for example https://www.imdb.com/title/tt0111161/.

Notable response behavior:

IMDb reports each figure independently. A real title with no reported box office data — most TV series and many non-theatrical titles — returns has_box_office: false with production_budget, opening_weekend, and every lifetime_gross field omitted, not an error.
lifetime_gross.domestic/.international/.worldwide are each an independent {amount, currency} figure and may be present or absent on their own.
opening_weekend covers the domestic market only; IMDb was verified to return no data for international or worldwide opening-weekend queries, so this API does not expose them.
A well-formed but unresolvable title ID returns a not-found error.
If IMDb changes the shape of this data, the endpoint fails closed with an upstream parser-drift error.

Live monitoring

Monitored request: GET /imdb/title/box-office?id=tt0111161
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.33 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/title/box-office?id=tt0111161
Fields returned with a value: 13

Field	In the sample	Value in the sample
id	Has a value
title	Has a value	“The Shawshank Redemption”
url	Has a value	imdb.com
has_box_office	Has a value	true
production_budget.amount	Has a value	25,000,000
production_budget.currency	Has a value	“USD”
opening_weekend.gross	Has a value
opening_weekend.theater_count	Has a value	33
opening_weekend.weekend_start_date	Has a value	1994-09-23
opening_weekend.weekend_end_date	Has a value	1994-09-25
lifetime_gross.domestic	Has a value
lifetime_gross.international	Has a value
lifetime_gross.worldwide	Has a value

Request parameters

Parameter	Type	Required	Description	Example
id	string	No	IMDb title id	tt0111161
url	string	No	Absolute https://www.imdb.com/title/<id>/ URL	https://www.imdb.com/title/tt0111161/
x-api-key (header)	string	Yes	API key required

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "tt0111161",
    "title": "The Shawshank Redemption",
    "url": "https://www.imdb.com/title/tt0111161/",
    "has_box_office": true,
    "production_budget": {
      "amount": 25000000,
      "currency": "USD"
    },
    "opening_weekend": {
      "gross": {
        "amount": 727327,
        "currency": "USD"
      },
      "theater_count": 33,
      "weekend_start_date": "1994-09-23",
      "weekend_end_date": "1994-09-25"
    },
    "lifetime_gross": {
      "domestic": {
        "amount": 28767189,
        "currency": "USD"
      },
      "international": {
        "amount": 628529,
        "currency": "USD"
      },
      "worldwide": {
        "amount": 29425268,
        "currency": "USD"
      }
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.titleBoxOfficeResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	imdb.TitleBoxOfficeResponse	No
data.fetched_at	string	No	2026-09-17T14:46:16Z
data.has_box_office	boolean	No	true
data.id	string	No	tt0111161
data.lifetime_gross	imdb.LifetimeGross	No
data.lifetime_gross.domestic	imdb.Money	No
data.lifetime_gross.domestic.amount	integer	No	28767189
data.lifetime_gross.domestic.currency	string	No	USD
data.lifetime_gross.international	imdb.Money	No
data.lifetime_gross.international.amount	integer	No	28767189
data.lifetime_gross.international.currency	string	No	USD
data.lifetime_gross.worldwide	imdb.Money	No
data.lifetime_gross.worldwide.amount	integer	No	28767189
data.lifetime_gross.worldwide.currency	string	No	USD
data.opening_weekend	imdb.OpeningWeekend	No
data.opening_weekend.gross	imdb.Money	No
data.opening_weekend.gross.amount	integer	No	28767189
data.opening_weekend.gross.currency	string	No	USD
data.opening_weekend.theater_count	integer	No	3
data.opening_weekend.weekend_end_date	string	No	1994-09-25
data.opening_weekend.weekend_start_date	string	No	1994-09-23
data.production_budget	imdb.Money	No
data.production_budget.amount	integer	No	28767189
data.production_budget.currency	string	No	USD
data.source_url	string	No	https://www.imdb.com/title/tt0111161/
data.title	string	No	The Shawshank Redemption
data.url	string	No	https://www.imdb.com/title/tt0111161/
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/imdb/title/box-office" \
  -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

IMDb title box office summary 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

IMDb title box office summary 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