---
title: "Facet the Box Office Mojo dataset"
method: GET
path: "/datasets/boxofficemojo/facets"
tags: ["Datasets"]
---

# Facet the Box Office Mojo dataset

`GET /datasets/boxofficemojo/facets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/boxofficemojo/facets`
- Auth: API key in header `x-api-key`

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`.

## Query parameters

- `facet` 'gross_band' | 'years_active' | 'lifetime_year' | 'franchise_names' | 'brand_names' | 'genre_names' | 'hydrated' | 'is_billion_dollar' | 'in_lifetime_top_1000_ww', required
- `q` string
- `title_id` string
- `year` integer
- `lifetime_year` integer
- `gross_band` string
- `franchise` string
- `brand` string
- `genre` string
- `in_lifetime_top_1000` boolean
- `min_worldwide` integer
- `max_worldwide` integer
- `min_domestic` integer
- `min_foreign_share` number
- `max_domestic_share` number
- `hydrated` boolean
- `is_billion_dollar` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsBoxOfficeMojoFacetResponseDoc
  - `code` integer
  - `data` DatasetsBoxOfficeMojoFacetResponse
    - `dataset` string
    - `facet` string
    - `items` EsBoxOfficeMojoDatasetFacetItem[]
      - `count` integer
      - `value` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)