Endpoint Playground

Try the Search the Box Office Mojo dataset API

Test Crawlora's Search the Box Office Mojo dataset API with realistic prefilled filters. Generate a cURL request, inspect stored structured JSON records, and open the full docs or pricing page when you are ready to integrate dataset search. Dataset Playground requests query indexed data and do not apply proxy routing.

Endpoint facts

Method: GET
API path: /datasets/boxofficemojo/search
Platform: Datasets
Auth: apiKey
Credits: 2 credits/request
Required params: None
Common optional params: q, title_id, year, lifetime_year, gross_band, franchise

Search the Box Office Mojo dataset API documentation Datasets platform page Crawlora API pricing Try Stored Datasets List API Try Airbnb Markets Dataset Facets API Try Airbnb Markets Dataset Country API Try Nearby Airbnb Markets Dataset API Try Airbnb Markets Dataset Search API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/boxofficemojo/search?gross_band=under_50m&sort=relevance" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
q	string	No		Full-text query over title and taxonomy names, max 256 characters
title_id	string	No		Exact title id (IMDb tt… id used by Box Office Mojo), max 32 characters
year	integer	No		Year that must appear in years_active
lifetime_year	integer	No		Primary lifetime chart year
gross_band	string	No	under_50m	Gross band enum: under_50m, 50_100m, 100_250m, 250_500m, 500m_1b, over_1b
franchise	string	No		Franchise name filter, max 128 characters
brand	string	No		Brand name filter, max 128 characters
genre	string	No		Genre name filter, max 128 characters
in_lifetime_top_1000	boolean	No		Only titles in the lifetime worldwide top 1000 chart
hydrated	boolean	No		Only titles with hydrated release groups and market grosses
is_billion_dollar	boolean	No		Only titles with worldwide gross of at least $1B
min_worldwide	integer	No		Minimum lifetime worldwide gross in whole USD dollars
max_worldwide	integer	No		Maximum lifetime worldwide gross in whole USD dollars
min_domestic	integer	No		Minimum lifetime domestic gross in whole USD dollars
min_foreign_share	number	No		Minimum foreign share of worldwide gross, 0 through 1
max_domestic_share	number	No		Maximum domestic share of worldwide gross, 0 through 1
sort	string	No	relevance	Sort enum: relevance, worldwide_desc, domestic_desc, peak_worldwide_desc, lifetime_rank_asc, year_desc, year_asc
page	integer	No		Page number, defaults to 1
page_size	integer	No		Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "items": [
      {
        "title_id": "tt0499549",
        "title": "Avatar",
        "lifetime_gross_worldwide": 2923710708,
        "gross_band": "over_1b",
        "is_billion_dollar": true,
        "hydrated": true
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1000,
    "sort": "worldwide_desc"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

109 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestdatasets.boxOfficeMojoSearchResponseDocDatasets

GET /datasets/boxofficemojo/search

Search the Box Office Mojo dataset

Searches theatrical box-office records from public Box Office Mojo charts and title pages, stored in a search index. Filter by title id, year, franchise/brand/genre, gross band, lifetime top-1000 membership, hydration status, and worldwide/domestic gross ranges. Sort enum: `relevance`, `worldwide_desc`, `domestic_desc`, `peak_worldwide_desc`, `lifetime_rank_asc`, `year_desc`, `year_asc`. gross_band enum: `under_50m`, `50_100m`, `100_250m`, `250_500m`, `500m_1b`, `over_1b`.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "items": [
      {
        "title_id": "tt0499549",
        "title": "Avatar",
        "lifetime_gross_worldwide": 2923710708,
        "gross_band": "over_1b",
        "is_billion_dollar": true,
        "hydrated": true
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1000,
    "sort": "worldwide_desc"
  }
}

Endpoint details

Method: GET
Path: /datasets/boxofficemojo/search
Authentication: apiKey
Credit cost: 2 credits/request
Platform: Datasets
Parameters: 20 documented fields

Request parameters

q:querytitle_id:queryyear:querylifetime_year:querygross_band:queryfranchise:querybrand:querygenre:queryin_lifetime_top_1000:queryhydrated:queryis_billion_dollar:querymin_worldwide:query+8 more

Response schema fields

codedatadata.datasetdata.itemsdata.items[].brand_idsdata.items[].brand_namesdata.items[].domestic_sharedata.items[].first_seen_atdata.items[].foreign_sharedata.items[].franchise_idsdata.items[].franchise_namesdata.items[].genre_ids

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "items": [
      {
        "title_id": "tt0499549",
        "title": "Avatar",
        "lifetime_gross_worldwide": 2923710708,
        "gross_band": "over_1b",
        "is_billion_dollar": true,
        "hydrated": true
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1000,
    "sort": "worldwide_desc"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/datasets/boxofficemojo/search" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing List stored scraped datasets Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset

Endpoint Playground

Try the Search the Box Office Mojo dataset API

Endpoint facts

Method: GET
API path: /datasets/boxofficemojo/search
Platform: Datasets
Auth: apiKey
Credits: 2 credits/request
Required params: None
Common optional params: q, title_id, year, lifetime_year, gross_band, franchise

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/boxofficemojo/search?gross_band=under_50m&sort=relevance" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
q	string	No		Full-text query over title and taxonomy names, max 256 characters
title_id	string	No		Exact title id (IMDb tt… id used by Box Office Mojo), max 32 characters
year	integer	No		Year that must appear in years_active
lifetime_year	integer	No		Primary lifetime chart year
gross_band	string	No	under_50m	Gross band enum: under_50m, 50_100m, 100_250m, 250_500m, 500m_1b, over_1b
franchise	string	No		Franchise name filter, max 128 characters
brand	string	No		Brand name filter, max 128 characters
genre	string	No		Genre name filter, max 128 characters
in_lifetime_top_1000	boolean	No		Only titles in the lifetime worldwide top 1000 chart
hydrated	boolean	No		Only titles with hydrated release groups and market grosses
is_billion_dollar	boolean	No		Only titles with worldwide gross of at least $1B
min_worldwide	integer	No		Minimum lifetime worldwide gross in whole USD dollars
max_worldwide	integer	No		Maximum lifetime worldwide gross in whole USD dollars
min_domestic	integer	No		Minimum lifetime domestic gross in whole USD dollars
min_foreign_share	number	No		Minimum foreign share of worldwide gross, 0 through 1
max_domestic_share	number	No		Maximum domestic share of worldwide gross, 0 through 1
sort	string	No	relevance	Sort enum: relevance, worldwide_desc, domestic_desc, peak_worldwide_desc, lifetime_rank_asc, year_desc, year_asc
page	integer	No		Page number, defaults to 1
page_size	integer	No		Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "items": [
      {
        "title_id": "tt0499549",
        "title": "Avatar",
        "lifetime_gross_worldwide": 2923710708,
        "gross_band": "over_1b",
        "is_billion_dollar": true,
        "hydrated": true
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1000,
    "sort": "worldwide_desc"
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

109 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestdatasets.boxOfficeMojoSearchResponseDocDatasets

GET /datasets/boxofficemojo/search

Search the Box Office Mojo dataset

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "items": [
      {
        "title_id": "tt0499549",
        "title": "Avatar",
        "lifetime_gross_worldwide": 2923710708,
        "gross_band": "over_1b",
        "is_billion_dollar": true,
        "hydrated": true
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1000,
    "sort": "worldwide_desc"
  }
}

Endpoint details

Method: GET
Path: /datasets/boxofficemojo/search
Authentication: apiKey
Credit cost: 2 credits/request
Platform: Datasets
Parameters: 20 documented fields

Request parameters

q:querytitle_id:queryyear:querylifetime_year:querygross_band:queryfranchise:querybrand:querygenre:queryin_lifetime_top_1000:queryhydrated:queryis_billion_dollar:querymin_worldwide:query+8 more

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "items": [
      {
        "title_id": "tt0499549",
        "title": "Avatar",
        "lifetime_gross_worldwide": 2923710708,
        "gross_band": "over_1b",
        "is_billion_dollar": true,
        "hydrated": true
      }
    ],
    "page": 1,
    "page_size": 20,
    "total": 1000,
    "sort": "worldwide_desc"
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/datasets/boxofficemojo/search" \
  -H "x-api-key: $CRAWLORA_API_KEY"