# Boxofficemojo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track and analyze box office performance data by searching for movies, viewing detailed metrics, comparing charts, and checking upcoming release schedules. Access comprehensive information on movie performance including daily charts, all-time worldwide rankings, and release-specific performance data.

**Category:** Entertainment | **Website:** [boxofficemojo.com/](https://boxofficemojo.com/) | **Docs:** [parse.bot/marketplace/b365cb63-840b-4c5b-ac66-52644b43f51b/boxofficemojo-com-api](https://parse.bot/marketplace/b365cb63-840b-4c5b-ac66-52644b43f51b/boxofficemojo-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-boxofficemojo-com-api-b365cb63/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_time_worldwide

Retrieve all-time worldwide box office rankings. Returns the top grossing movies of all time with domestic and foreign gross breakdowns, percentages, and release year. Each entry includes an imdb_id for drilling into movie details.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boxofficemojo-com-api-b365cb63/get_all_time_worldwide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_daily_chart

Retrieve the domestic daily box office chart for a specific date. Returns a ranked list of movies with daily earnings, theater count, per-theater average, cumulative total, days in release, and distributor. Each entry includes a release_id for drilling into performance history. Omitting date returns the most recent available daily chart.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns the most recent available daily chart. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boxofficemojo-com-api-b365cb63/get_daily_chart \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### get_movie_details

Get comprehensive details for a movie including gross summary (domestic, international, worldwide), release information, summary metadata (distributor, budget, rating, runtime, genres), and market breakdowns by region. The imdb_id can be obtained from search_movies results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `imdb_id` | string | Yes | IMDb Title ID (e.g., tt0499549). Obtainable from search_movies results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boxofficemojo-com-api-b365cb63/get_movie_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"imdb_id":"<string>"}'
```

### get_movie_release_performance

Get detailed performance table (daily, weekend, or weekly) for a specific movie release. Returns time-series box office metrics including date, rank, daily earnings, theater count, average, cumulative total, and day number. The release_id can be obtained from get_daily_chart results or get_movie_details releases.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `release_id` | string | Yes | Release ID (e.g., rl1416265729). Obtainable from get_daily_chart results or get_movie_details releases. |
| `type` | string | No | Type of performance data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boxofficemojo-com-api-b365cb63/get_movie_release_performance \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"release_id":"<string>","type":"<string>"}'
```

### get_release_schedule

Get upcoming movie release schedule. Returns a list of upcoming theatrical releases with dates, distributors, release scale (Wide/Limited), and release_ids for drilling into performance once released. Results are ordered chronologically.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boxofficemojo-com-api-b365cb63/get_release_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_movies

Full-text search for movies by title keyword. Returns a list of matching movies with their IMDb IDs and Box Office Mojo URLs. Results are ordered by relevance. No pagination — a single page of results is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Movie title search query. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boxofficemojo-com-api-b365cb63/search_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```