# IMDb — 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 retrieve comprehensive IMDb movie information including ratings, genres, cast, crew, and box office data in one place. Get full cast and crew details alongside plot summaries and financial insights for any movie title.

**Category:** Entertainment | **Website:** [imdb.com/](https://imdb.com/) | **Docs:** [parse.bot/marketplace/e001ed66-d8c4-411a-b0b8-f40800028068/imdb-com-api](https://parse.bot/marketplace/e001ed66-d8c4-411a-b0b8-f40800028068/imdb-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-imdb-com-api-e001ed66/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_full_cast

Get the complete cast list for a movie with cursor-based pagination support. Use this when you need all cast members beyond what get_movie_details returns. Each page returns up to 50 cast members with a cursor for the next page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Cursor for pagination (from end_cursor of previous response). |
| `limit` | integer | No | Number of cast members per page (max 50). |
| `title_id` | string | Yes | IMDb title ID (e.g., tt0816692). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imdb-com-api-e001ed66/get_full_cast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","limit":"<integer>","title_id":"<string>"}'
```

### get_movie_details

Get comprehensive movie details including title, plot overview, IMDb rating, genres, cast (with character names), directors, writers, budget, box office, keywords, and more. The cast returned is capped by cast_limit; use get_full_cast for the complete list with pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cast_limit` | integer | No | Maximum number of cast members to return (max 50). |
| `title_id` | string | Yes | IMDb title ID (e.g., tt0816692). The 'tt' prefix is optional. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imdb-com-api-e001ed66/get_movie_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cast_limit":"<integer>","title_id":"<string>"}'
```

### get_popular_movies

Get the most popular movies from IMDb's Movie Meter chart (https://www.imdb.com/chart/moviemeter/). Returns up to 100 movies ranked by current popularity, with title, poster image, rating, release year, genres, languages, plot, runtime, and content rating. Supports cursor-based pagination via the 'after' parameter. Each page returns up to 'limit' movies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Cursor for pagination (from end_cursor of previous response). |
| `limit` | integer | No | Number of movies per page (max 100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imdb-com-api-e001ed66/get_popular_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","limit":"<integer>"}'
```