# The Numbers — 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.

> Search and discover comprehensive movie industry data including box office statistics, cast and crew information, and all-time records directly from the-numbers.com. Track daily box office charts and retrieve detailed movie information to stay informed about film performance and historical cinema records.

**Category:** Entertainment | **Website:** [the-numbers.com/](https://the-numbers.com/) | **Docs:** [parse.bot/marketplace/1de62da4-36a3-4487-b949-907d1296773e/the-numbers-com-api](https://parse.bot/marketplace/1de62da4-36a3-4487-b949-907d1296773e/the-numbers-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-the-numbers-com-api-1de62da4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_time_box_office_records

Get all-time box office records

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category: domestic, international, or worldwide |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-the-numbers-com-api-1de62da4/get_all_time_box_office_records \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_daily_box_office_chart

Get the daily domestic box office chart for a given date. Returns ranked list of movies with their daily gross, theater count, daily/weekly changes, and cumulative total gross. When no date is given, returns the latest available daily chart.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY/MM/DD format (e.g. '2025/12/25'). If omitted, returns the latest available daily chart. |

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

### get_movie_cast_and_crew

Get cast and crew for a movie

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Movie slug (e.g. 'Scream-7-(2026)') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-the-numbers-com-api-1de62da4/get_movie_cast_and_crew \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_movie_details

Get comprehensive details for a movie including box office gross revenue, production budget, synopsis, genre, runtime, and other metadata. The slug can be obtained from search_movies results or daily chart Title_slug field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Movie slug from URL path (e.g. 'Avatar-(2009)', 'Avatar-Fire-and-Ash-(2025)'). Obtainable from search_movies results or daily chart Title_slug field. |

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

### search_movies

Search for movies by title using the site's autocomplete API. Returns up to 10 movie results matching the query, filtered to movies only (excludes franchises). Each result includes title, slug, year, lead cast, and director when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or movie title to search for |

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