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

# Box Office Mojo showdown detail

`GET /boxofficemojo/showdown`

## Request

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

Returns release comparison metrics from a Box Office Mojo showdown page. Pass exactly one of `id`, `path`, or `url`.

## Query parameters

- `id` string
- `path` string
- `url` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BoxofficemojoShowdownResponseDoc
  - `code` integer
  - `data` BoxofficemojoShowdownResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `name` string: Showdown name, for example `12 Years of Nancy Meyers`.
    - `path` string: Path of the showdown page on Box Office Mojo, for example `/showdown/sd943519236/`.
    - `public_page_derived` boolean: Always `true`; the values come from Box Office Mojo's public pages.
    - `releases` BoxofficemojoShowdownRelease[]: Releases compared in the showdown, one item per release.
      - `close_date` string: Date the release left theaters, as shown on the showdown page.
      - `distributor` string: Studio or distributor handling the release.
      - `domestic_gross` integer: Domestic gross of the release, in US dollars.
      - `domestic_gross_raw` string: Domestic gross, as Box Office Mojo displays it, for example `$75,764,672`.
      - `domestic_share` number: Domestic gross as a fraction of worldwide gross (0.389 is 38.9%).
      - `foreign_gross` integer: Foreign gross of the release, in US dollars.
      - `foreign_gross_raw` string: Foreign gross, as Box Office Mojo displays it, for example `$119,000,000`.
      - `foreign_share` number: Foreign gross as a fraction of worldwide gross (0.611 is 61.1%).
      - `genre` string: Genre label shown for the release, for example `Comedy Drama`.
      - `gross_to_date` integer: Gross of the release to date, in US dollars.
      - `gross_to_date_raw` string: Gross to date, as Box Office Mojo displays it, for example `$75,764,672`.
      - `mpa_rating` string: MPA rating of the release, for example `PG-13`.
      - `opening_share` number: Opening weekend gross as a fraction of total gross (0.234 is 23.4%).
      - `opening_weekend` integer: Opening weekend gross, in US dollars.
      - `opening_weekend_raw` string: Opening weekend gross, as Box Office Mojo displays it, for example `$17,728,313`.
      - `production_budget` integer: Production budget of the release, in US dollars.
      - `production_budget_raw` string: Production budget, as Box Office Mojo displays it, for example `$35,000,000`.
      - `release` string: Release name as shown on the showdown page.
      - `release_date` string: Release date as shown on the showdown page, for example `Sep 25, 2015`.
      - `release_path` string: Path of the release page on Box Office Mojo, for example `/release/rl861570561/`.
      - `release_url` string: Full URL of the release page on Box Office Mojo.
      - `running_time` string: Running time as shown, for example `2 hr 1 min`.
      - `weekends_at_number_one` integer: Number of weekends the release ranked first on the domestic weekend chart.
      - `weekends_in_top_ten` integer: Number of weekends the release ranked in the top ten of the domestic weekend chart.
      - `widest_release` integer: Largest number of theaters the release played in at once.
      - `worldwide_gross` integer: Worldwide gross of the release, in US dollars.
      - `worldwide_gross_raw` string: Worldwide gross, as Box Office Mojo displays it, for example `$194,764,672`.
    - `showdown_id` string: Box Office Mojo showdown id, starting with `sd`.
    - `source_url` string: URL of the Box Office Mojo page the data was read from.
    - `summary` BoxofficemojoShowdownSummary
      - `highest_opening_release` string: Release with the highest opening weekend gross in the showdown.
      - `highest_opening_weekend` integer: Opening weekend gross of that release, in US dollars.
      - `release_count` integer: Number of releases in the showdown.
      - `top_domestic_gross` integer: Domestic gross of the top domestic release, in US dollars.
      - `top_domestic_release` string: Release with the highest domestic gross in the showdown.
      - `top_worldwide_gross` integer: Worldwide gross of the top worldwide release, in US dollars.
      - `top_worldwide_release` string: Release with the highest worldwide gross in the showdown.
      - `total_domestic_gross` integer: Combined domestic gross of the releases in the showdown, in US dollars.
      - `total_worldwide_gross` integer: Combined worldwide gross of the releases in the showdown, in US dollars.
    - `url` string: Full URL of the showdown 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/afac9b012a27?raw)