---
title: "Box Office Mojo franchise detail"
method: GET
path: "/boxofficemojo/franchise"
tags: ["Box Office Mojo"]
---

# Box Office Mojo franchise detail

`GET /boxofficemojo/franchise`

## Request

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

Returns release rows from a Box Office Mojo franchise page. Pass exactly one of `id`, `path`, or `url`.

## Query parameters

- `id` string
- `path` string
- `url` string
- `sort` 'grossToDate' | 'maxNumTheaters' | 'openingWeekendGross' | 'openingNumTheaters' | 'releaseDate'
- `sortDir` 'asc' | 'desc'
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BoxofficemojoTaxonomyDetailResponseDoc
  - `code` integer
  - `data` BoxofficemojoTaxonomyDetailResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `has_more` boolean: HasMore is true when this page returned a full page of rows (100), so a higher offset may return additional results. Box Office Mojo's taxonomy detail pages paginate at 100 rows/page with no total-count marker, so this is a page-size heuristic, not an exact "more data exists" signal.
    - `id` string: Box Office Mojo id of the franchise, brand or genre.
    - `kind` string: Type of group: `franchise`, `brand` or `genre`.
    - `name` string: Name of the franchise, brand or genre.
    - `offset` integer: Number of rows skipped before this page.
    - `path` string: Path of the group's page on Box Office Mojo, for example `/franchise/fr541495045/`.
    - `public_page_derived` boolean: Always `true`; the values come from Box Office Mojo's public pages.
    - `results` BoxofficemojoTaxonomyMovieRow[]: Releases in the group on this page, one item per release.
      - `distributor` string: Studio or distributor handling the release.
      - `lifetime_gross` integer: Lifetime gross of the release, in US dollars.
      - `lifetime_gross_raw` string: Lifetime gross, as Box Office Mojo displays it, for example `$623,357,910`.
      - `max_theaters` integer: Largest number of theaters the release played in.
      - `open_theaters` integer: Number of theaters the release opened in.
      - `opening` integer: Opening gross of the release, in US dollars.
      - `opening_raw` string: Opening gross, as Box Office Mojo displays it, for example `$207,438,708`.
      - `rank` integer: Position within the group.
      - `release` string: Release name as shown on the group page.
      - `release_date` string: Release date as shown, for example `May 4, 2012`.
      - `release_id` string: Live franchise/brand/genre detail pages often link /release/rl…/ instead of /title/tt….
      - `release_note` string: ReleaseNote carries the secondary label Box Office Mojo renders under the release name to distinguish one release of a film from another — e.g. "2022 Re-release", "2010 Special Edition", "2012 3D Release". A film with re-releases appears as several rows sharing one title but differing here.
      - `release_path` string: Path of the release page on Box Office Mojo, for example `/release/rl3059975681/`.
      - `release_url` string: Full URL of the release page on Box Office Mojo.
      - `title_id` string: Title id of the film, starting with `tt`, when the page links to a title.
      - `title_path` string: Path of the title page on Box Office Mojo, when the page links to one.
      - `title_url` string: Full URL of the title page on Box Office Mojo, when the page links to one.
    - `sort` string: Sort order applied: `grossToDate`, `maxNumTheaters`, `openingWeekendGross`, `openingNumTheaters` or `releaseDate`.
    - `sort_dir` string: Sort direction applied: `asc` or `desc`.
    - `source_url` string: URL of the Box Office Mojo page the data was read from.
    - `summary` BoxofficemojoTaxonomySummary
      - `movie_count` integer: Number of releases in `results` on this page.
      - `top_distributor` string: Distributor with the most releases in `results`.
      - `top_release` string: Release with the highest lifetime gross in `results`.
      - `top_release_gross` integer: Lifetime gross of the top release, in US dollars.
      - `total_gross` integer: Combined lifetime gross of the releases in `results`, in US dollars.
    - `url` string: Full URL of the group's page on Box Office Mojo.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[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)