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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/get_all_films \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/get_closet_picks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/get_current_post_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/get_current_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/get_film_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/get_top10_list_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/get_top10_lists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-criterion-com-api-45864560/search_films \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```