---
title: "Box Office Mojo domestic yearly box office"
method: GET
path: "/boxofficemojo/year/domestic"
tags: ["Box Office Mojo"]
---

# Box Office Mojo domestic yearly box office

`GET /boxofficemojo/year/domestic`

## Request

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

Returns the Box Office Mojo domestic box office chart for one year. `year` is required and runs from 1977 to 2100. Each row has `rank`, `release`, `release_date`, `distributor`, `theaters`, `gross`, `total_gross` and `new_this_year`, each gross also with its displayed text in a `_raw` field.

## Query parameters

- `year` integer, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BoxofficemojoDomesticYearResponseDoc
  - `code` integer
  - `data` BoxofficemojoDomesticYearResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `grosses_option` string: Grosses view of the yearly chart; always `calendar_grosses`, which counts gross earned within the calendar year.
    - `public_page_derived` boolean: Always `true`; the values come from Box Office Mojo's public pages.
    - `results` BoxofficemojoDomesticYearRow[]: Rows of the domestic yearly chart, one per release, in chart order.
      - `distributor` string: Studio or distributor handling the release.
      - `gross` integer: Domestic gross earned within the calendar year, in US dollars.
      - `gross_raw` string: Domestic gross within the year, as Box Office Mojo displays it, for example `$423,778,855`.
      - `new_this_year` boolean: `true` when Box Office Mojo flags the row's yearly figures as estimates.
      - `rank` integer: Position on the yearly chart.
      - `release` string: Release name as shown on the yearly chart.
      - `release_date` string: Release date as shown on the chart, for example `May 23`.
      - `release_path` string: Path of the release page on Box Office Mojo, for example `/release/rl4045406209/`.
      - `release_url` string: Full URL of the release page on Box Office Mojo.
      - `theaters` integer: Number of theaters showing the release.
      - `total_gross` integer: Domestic gross of the release to date, in US dollars.
      - `total_gross_raw` string: Domestic gross to date, as Box Office Mojo displays it, for example `$423,778,855`.
    - `source_url` string: URL of the Box Office Mojo page the data was read from.
    - `year` integer: Calendar year of the chart.
  - `msg` string

## Other responses

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