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

# Box Office Mojo domestic weekend estimates

`GET /boxofficemojo/weekend/domestic/estimates`

## Request

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

Returns estimate-vs-actual rows from Box Office Mojo's domestic weekend estimates 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

- BoxofficemojoWeekendEstimatesResponseDoc
  - `code` integer
  - `data` BoxofficemojoWeekendEstimatesResponse
    - `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` BoxofficemojoWeekendEstimateRow[]: Rows comparing estimated and actual weekend figures, one per release.
      - `actual_gross` integer: Actual weekend gross, in US dollars.
      - `actual_gross_raw` string: Actual weekend gross, as Box Office Mojo displays it, for example `$63,087,667`.
      - `actual_rank` integer: Position on the chart once actual figures were reported.
      - `actual_total` integer: Actual domestic gross to date, in US dollars.
      - `actual_total_raw` string: Actual domestic gross to date, as Box Office Mojo displays it, for example `$216,914,790`.
      - `distributor` string: Studio or distributor handling the release.
      - `estimated_gross` integer: Estimated weekend gross, in US dollars.
      - `estimated_gross_raw` string: Estimated weekend gross, as Box Office Mojo displays it, for example `$62,000,000`.
      - `estimated_rank` integer: Position on the chart by estimated weekend gross.
      - `estimated_total` integer: Estimated domestic gross to date, in US dollars.
      - `estimated_total_raw` string: Estimated domestic gross to date, as Box Office Mojo displays it, for example `$215,000,000`.
      - `gross_diff` integer: Actual weekend gross minus estimated weekend gross, in US dollars.
      - `gross_diff_percent` number: Gross difference as a fraction (0.018 is 1.8%).
      - `gross_diff_raw` string: Gross difference, as Box Office Mojo displays it, for example `$1,087,667`.
      - `rank_diff` integer: Difference between the estimated rank and the actual rank.
      - `release` string: Release name as shown on the estimates chart.
      - `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.
      - `theaters` integer: Number of theaters showing the release that weekend.
      - `weekend_in_release` integer: Weekend number of the release's run, as shown in the Weekend column.
    - `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)