# Criterion Collection — 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.

> Browse and search the Criterion Collection's curated film catalog, explore editorial content and posts from Current magazine, and retrieve Top 10 lists and Closet Picks. Get detailed information about individual films and curated collections.

**Category:** Entertainment | **Website:** [criterion.com/](https://criterion.com/) | **Docs:** [parse.bot/marketplace/45864560-7888-410d-99ae-5b9dfca9eda9/criterion-com-api](https://parse.bot/marketplace/45864560-7888-410d-99ae-5b9dfca9eda9/criterion-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/criterion-collection/`
**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 films

Browse the Criterion Collection catalog with various filters. Returns a list of films with spine number, title, director, country, and year. The full catalog contains ~1800 films returned in a single page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Filter by country (e.g., Japan, France). |
| `decade` | string | No | Filter by decade (e.g., 1960s). |
| `director` | string | No | Filter by director slug. |
| `format` | string | No | Filter by format. |
| `genre` | string | No | Filter by genre slug. |
| `query` | string | No | Search query within catalog. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/get-all-films \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","decade":"<string>","director":"<string>","format":"<string>","genre":"<string>","query":"<string>","sort":"<string>"}'
```

### Get closet picks

Get a list of Closet Picks videos and collections from the Criterion closet picks page. Returns all available picks with title and URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/get-closet-picks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get current post detail

Get the content of an individual editorial post. Returns the post title and full text content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the editorial post (e.g., https://www.criterion.com/current/posts/9129-sinister-synergies). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/get-current-post-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get current posts

Get a list of editorial posts from the Current magazine. Without a category, returns posts from the landing page. With a category, returns posts from that category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug (e.g., 3-features, 1-essays, 8-top-10-lists, 2-interviews). |
| `limit` | integer | No | Maximum number of posts to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/get-current-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>"}'
```

### Get film detail

Get detailed information about a specific film by its URL. Returns title, director, synopsis, technical details (country, year, runtime, format, aspect ratio, language, spine number), and special features.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the film page (e.g., https://www.criterion.com/films/351-grand-illusion). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/get-film-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get top10 list detail

Get the full picks from a specific Top 10 list. Returns the list title, author name, and array of film titles picked.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the Top 10 list page (e.g., https://www.criterion.com/current/top-10-lists/954-julio-torres-s-top-10). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/get-top10-list-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get top10 lists

Get a paginated list of Top 10 lists from Criterion's Current editorial section. Each list includes the title, author name, publication date, URL, and ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of lists to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/get-top10-lists \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Search films

Search for films using Criterion's global search. Returns matching films and box sets with title, director, and URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/criterion-collection/search-films \
  -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.