---
title: "Box Office Mojo domestic release schedule"
method: GET
path: "/boxofficemojo/calendar"
tags: ["Box Office Mojo"]
---

# Box Office Mojo domestic release schedule

`GET /boxofficemojo/calendar`

## Request

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

Returns Box Office Mojo's domestic release schedule for one month, grouped by date. `year` (1921 to 2100) and `month` (1 to 12) are both required. Each release has its title, `release_url`, `distributor`, `scale`, `genres`, `cast` and poster image URLs when present.

## Query parameters

- `year` integer, required
- `month` integer, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BoxofficemojoCalendarResponseDoc
  - `code` integer
  - `data` BoxofficemojoCalendarResponse
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `month` integer: Calendar month requested, as a number.
    - `public_page_derived` boolean: Always `true`; the values come from Box Office Mojo's public pages.
    - `results` BoxofficemojoCalendarDateRows[]: Release dates in the month, each with the releases scheduled for it.
      - `date` string: Release date heading as shown on the calendar, for example `September 4, 2026`.
      - `releases` BoxofficemojoCalendarReleaseRow[]: Releases scheduled for that date, one item per release.
        - `cast` string[]: Names of the cast members listed for the release.
        - `distributor` string: Studio or distributor handling the release.
        - `genres` string[]: Genres listed for the release.
        - `image_hi_res_url` string: URL of the larger poster image for the release.
        - `image_url` string: URL of the poster image for the release.
        - `release` string: Release name as shown on the calendar.
        - `release_id` string: Box Office Mojo release id, starting with `rl`. Use it with the release endpoint.
        - `release_path` string: Path of the release page on Box Office Mojo, for example `/release/rl564363265/`.
        - `release_url` string: Full URL of the release page on Box Office Mojo.
        - `scale` string: Release scale shown on the calendar, for example `Wide`.
        - `title_id` string: Title id of the film, starting with `tt`. Use it with the title endpoint.
        - `title_path` string: Path of the title page on Box Office Mojo, for example `/title/tt0499549/`.
        - `title_url` string: Full URL of the title page on Box Office Mojo.
    - `source_url` string: URL of the Box Office Mojo page the data was read from.
    - `year` integer: Calendar year requested.
  - `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/028417aa35bb?raw)