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

# Box Office Mojo domestic weekend box office

`GET /boxofficemojo/weekend/domestic`

## Request

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

Returns rows from Box Office Mojo's domestic weekend chart. Empty upstream weekend pages return a typed not-found error rather than an empty success.

## Query parameters

- `year` integer, required
- `week` integer, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BoxofficemojoDomesticWeekendResponseDoc
  - `code` integer
  - `data` BoxofficemojoDomesticWeekendResponse
    - `date_range` string: Weekend dates, for example `December 26-28, 2025`.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `public_page_derived` boolean: Always `true`; the values come from Box Office Mojo's public pages.
    - `results` BoxofficemojoDomesticWeekendRow[]: Rows of the domestic weekend chart, one per release, in chart order.
      - `average` integer: Average weekend gross per theater, in US dollars.
      - `average_raw` string: Average weekend gross per theater, as Box Office Mojo displays it, for example `$16,602`.
      - `change_percent` number: Change in weekend gross from the previous weekend, as a fraction (-0.292 is -29.2%).
      - `distributor` string: Studio or distributor handling the release.
      - `estimated` boolean: `true` when Box Office Mojo flags the weekend figures as estimates.
      - `gross` integer: Gross for the weekend, in US dollars.
      - `gross_raw` string: Weekend gross, as Box Office Mojo displays it, for example `$63,087,667`.
      - `last_week_rank` integer: Position on the previous weekend's chart.
      - `new_this_week` boolean: `true` when the release is new on the chart this weekend.
      - `rank` integer: Position on this weekend's chart.
      - `release` string: Release name as shown on the weekend chart.
      - `release_id` string: Live weekend charts typically link /release/rl…/ rather than /title/tt….
      - `release_path` string: Path of the release page on Box Office Mojo, for example `/release/rl3389031937/`.
      - `release_url` string: Full URL of the release page on Box Office Mojo.
      - `theater_change` integer: Change in theater count from the previous weekend.
      - `theaters` integer: Number of theaters showing the release that weekend.
      - `title_id` string: Title id of the film, starting with `tt`, when the chart links to a title page.
      - `title_path` string: Path of the title page on Box Office Mojo, when the chart links to one.
      - `title_url` string: Full URL of the title page on Box Office Mojo, when the chart links to one.
      - `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 `$216,914,790`.
      - `weeks` integer: Number of weeks the release has been in theaters.
    - `source_url` string: URL of the Box Office Mojo page the data was read from.
    - `week` integer: Week number of the requested weekend within the year.
    - `year` integer: Year of the requested weekend.
  - `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)