Endpoint Playground

Try the Facet the Box Office Mojo dataset API

Returns terms-aggregation counts for one facet of the Box Office Mojo dataset, scoped to the same filters as search. Facet enum: `gross_band`, `years_active`, `lifetime_year`, `franchise_names`, `brand_names`, `genre_names`, `hydrated`, `is_billion_dollar`, `in_lifetime_top_1000_ww`. gross_band enum: `under_50m`, `50_100m`, `100_250m`, `250_500m`, `500m_1b`, `over_1b`. Dataset Playground requests query indexed data and do not apply proxy routing.

What a live request returned

14 Oct 2026: 6 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/boxofficemojo/facets?facet=gross_band
Fields with a value in every checked item: value, count

Sample value profiles: count: 65 to 17,813, median 483.

Request: GET /datasets/boxofficemojo/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.31 s
Monitored request: GET /datasets/boxofficemojo/facets?facet=gross_band

Facet the Box Office Mojo dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/boxofficemojo/facets?facet=gross_band' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	gross_band	Facet enum: gross_band, years_active, lifetime_year, franchise_names, brand_names, genre_names, hydrated, is_billion_dollar, in_lifetime_top_1000_ww
q	string	No		Full-text query, 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 in years_active
lifetime_year	integer	No		Primary lifetime chart year
gross_band	string	No		Gross band filter
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
min_worldwide	integer	No		Minimum lifetime worldwide gross
max_worldwide	integer	No		Maximum lifetime worldwide gross
min_domestic	integer	No		Minimum lifetime domestic gross
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
hydrated	boolean	No		Hydrated filter
is_billion_dollar	boolean	No		Only titles with worldwide gross of at least $1B

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "facet": "gross_band",
    "items": [
      {
        "value": "over_1b",
        "count": 50
      },
      {
        "value": "500m_1b",
        "count": 120
      }
    ]
  }
}

More Datasets endpoints

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 Discover Apple Books dataset values Get an Apple Books record Search Apple Books records Facet stored Apple Maps places Get a stored Apple Maps place Find nearby stored Apple Maps places Search stored Apple Maps places All 165 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.boxOfficeMojoFacetResponseDocDatasets

GET /datasets/boxofficemojo/facets

Facet 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

Required query parameters

facet

requiredstring

Facet enum: gross_band, years_active, lifetime_year, franchise_names, brand_names, genre_names, hydrated, is_billion_dollar, in_lifetime_top_1000_ww · allowed: gross_band, years_active, lifetime_year, franchise_names, brand_names, genre_names, hydrated, is_billion_dollar, in_lifetime_top_1000_ww

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",
    "facet": "gross_band",
    "items": [
      {
        "value": "over_1b",
        "count": 50
      },
      {
        "value": "500m_1b",
        "count": 120
      }
    ]
  }
}

Endpoint Playground

Try the Facet the Box Office Mojo dataset API

What a live request returned

14 Oct 2026: 6 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/boxofficemojo/facets?facet=gross_band
Fields with a value in every checked item: value, count

Sample value profiles: count: 65 to 17,813, median 483.

Request: GET /datasets/boxofficemojo/facets
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.31 s
Monitored request: GET /datasets/boxofficemojo/facets?facet=gross_band

Facet the Box Office Mojo dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/boxofficemojo/facets?facet=gross_band' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	gross_band	Facet enum: gross_band, years_active, lifetime_year, franchise_names, brand_names, genre_names, hydrated, is_billion_dollar, in_lifetime_top_1000_ww
q	string	No		Full-text query, 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 in years_active
lifetime_year	integer	No		Primary lifetime chart year
gross_band	string	No		Gross band filter
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
min_worldwide	integer	No		Minimum lifetime worldwide gross
max_worldwide	integer	No		Maximum lifetime worldwide gross
min_domestic	integer	No		Minimum lifetime domestic gross
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
hydrated	boolean	No		Hydrated filter
is_billion_dollar	boolean	No		Only titles with worldwide gross of at least $1B

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "boxofficemojo",
    "facet": "gross_band",
    "items": [
      {
        "value": "over_1b",
        "count": 50
      },
      {
        "value": "500m_1b",
        "count": 120
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.boxOfficeMojoFacetResponseDocDatasets

GET /datasets/boxofficemojo/facets

Facet 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

Required query parameters

facet

requiredstring

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",
    "facet": "gross_band",
    "items": [
      {
        "value": "over_1b",
        "count": 50
      },
      {
        "value": "500m_1b",
        "count": 120
      }
    ]
  }
}