---
title: "Get a Box Office Mojo title from the dataset"
method: GET
path: "/datasets/boxofficemojo/items/{title_id}"
tags: ["Datasets"]
---

# Get a Box Office Mojo title from the dataset

`GET /datasets/boxofficemojo/items/{title_id}`

## Request

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

Returns one Box Office Mojo dataset record by title id (IMDb `tt…` id used on Box Office Mojo title pages), including lifetime grosses, year history, release groups and market grosses when hydrated.

## Path parameters

- `title_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsBoxOfficeMojoItemResponseDoc
  - `code` integer
  - `data` EsBoxOfficeMojoTitleRecord
    - `brand_ids` string[]
    - `brand_names` string[]
    - `domestic_share` number
    - `first_seen_at` string
    - `foreign_share` number
    - `franchise_ids` string[]
    - `franchise_names` string[]
    - `genre_ids` string[]
    - `genre_names` string[]
    - `gross_band` string
    - `hydrate_attempts` integer
    - `hydrate_failed` boolean
    - `hydrated` boolean
    - `in_lifetime_top_1000_dom` boolean
    - `in_lifetime_top_1000_ww` boolean
    - `is_billion_dollar` boolean
    - `last_crawled_at` string
    - `last_hydrated_at` string
    - `lifetime_gross_domestic` integer
    - `lifetime_gross_worldwide` integer
    - `lifetime_rank_domestic` integer
    - `lifetime_rank_worldwide` integer
    - `lifetime_year` integer
    - `market_count` integer
    - `market_grosses` object[]: MarketGrosses keeps the hydrated region/market tables as opaque objects so the mapping stays flexible; the public query surface can expand later.
    - `peak_worldwide_gross` integer
    - `peak_worldwide_year` integer
    - `primary_release_group_id` string
    - `primary_release_group_name` string
    - `release_group_count` integer
    - `release_group_ids` string[]
    - `release_groups` EsBoxOfficeMojoReleaseGroup[]
      - `domestic` integer
      - `international` integer
      - `markets` string
      - `name` string
      - `path` string
      - `rollout` string
      - `url` string
      - `worldwide` integer
    - `schema_version` integer
    - `sources` string[]
    - `title` string
    - `title_id` string
    - `title_path` string
    - `title_url` string
    - `year_grosses` EsBoxOfficeMojoYearGross[]
      - `domestic` integer
      - `domestic_share` number
      - `foreign` integer
      - `foreign_share` number
      - `rank_worldwide` integer
      - `release_group_id` string
      - `release_group_name` string
      - `worldwide` integer
      - `year` integer
    - `years_active` integer[]
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)