# Boxofficemojo — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/boxofficemojo/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/boxofficemojo/get-all-time-worldwide \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boxofficemojo/get-daily-chart \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boxofficemojo/get-movie-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boxofficemojo/get-movie-release-performance \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boxofficemojo/get-release-schedule \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/boxofficemojo/search-movies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.