# Yorck — 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 current and upcoming films at Berlin's Yorck Kinogruppe cinemas, check showtimes and schedules, and explore special events and membership options. Search for movies, view detailed cinema information, and plan your visits with comprehensive scheduling data across the entire theater chain.

**Category:** Entertainment | **Website:** [yorck.de/](https://yorck.de/) | **Docs:** [parse.bot/marketplace/98566fbd-90f5-4ab3-ba15-b434e3f3f71a/yorck-de-api](https://parse.bot/marketplace/98566fbd-90f5-4ab3-ba15-b434e3f3f71a/yorck-de-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-yorck-de-api-98566fbd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cinema_detail

Get detailed information for a specific cinema including address, history, accessibility details, gallery, transport info, screen info, and air conditioning details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cinema_slug` | string | Yes | URL slug of the cinema, obtainable from list_cinemas results (e.g. 'delphi-filmpalast', 'babylon-kreuzberg'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_cinema_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cinema_slug":"<string>"}'
```

### get_cinema_showtimes

Get films and showtimes at a specific cinema for a given date. Returns both regular films and special events scheduled at that cinema, each with embedded session times.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cinema_slug` | string | Yes | URL slug of the cinema, obtainable from list_cinemas results. |
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns the default schedule. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_cinema_showtimes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cinema_slug":"<string>","date":"<string>"}'
```

### get_coming_soon

Get films coming soon to Yorck cinemas. Returns upcoming releases not yet in regular rotation, each with slug, runtime, release date, and synopsis.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_coming_soon \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_film_detail

Get detailed information for a specific film including cast, director, synopsis, trailer YouTube IDs, poster, countries, and current sessions. The film_slug is obtainable from get_now_playing or search_films results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `film_slug` | string | Yes | URL slug of the film, obtainable from get_now_playing or search_films results (e.g. 'disclosure-day'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_film_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"film_slug":"<string>"}'
```

### get_film_showtimes

Get showtimes for a specific film, optionally filtered by date. Returns session objects with start times, screening formats (DF/OV/OmU), and cinema name. Without a date filter, all scheduled sessions are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Filter sessions by date in YYYY-MM-DD format. Omitting returns all available sessions. |
| `film_slug` | string | Yes | URL slug of the film, obtainable from get_now_playing or search_films results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_film_showtimes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","film_slug":"<string>"}'
```

### get_now_playing

Get films currently showing across all Yorck cinemas. Returns the full roster of films in regular rotation with embedded session previews (next 3 showtimes per film). Each film carries a slug for drill-down via get_film_detail.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_now_playing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_special_detail

Get details for a specific special event or film series including assigned films, cinema locations, schedule, description, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `special_slug` | string | Yes | URL slug of the special, obtainable from list_specials results (e.g. 'mongay', 'creepy-crypt', 'in-the-mood'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_special_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"special_slug":"<string>"}'
```

### get_unlimited_membership_info

Get details about the Yorck Unlimited membership subscription including pricing, benefits, and FAQs. Fetches content from the Contentful-powered experience page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_unlimited_membership_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_week_schedule

Get the full weekly film schedule across all Yorck cinemas. Returns all films currently showing with their embedded sessions for the week.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Start date for the weekly schedule in YYYY-MM-DD format. Omitting defaults to the current week. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/get_week_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### list_cinemas

List all Yorck Kinogruppe cinema locations with full details including name, address, district, slug, number of auditoriums, accessibility info, and short description.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/list_cinemas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_specials

List all special programming, film series, and festivals at Yorck cinemas. Returns three arrays: active specials (one-off screenings), recurring film series, and festivals.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/list_specials \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_films

Search for films by keyword among currently playing films. Performs case-insensitive substring matching against film titles. Returns matching films in the same structure as get_now_playing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against film titles (case-insensitive substring match). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yorck-de-api-98566fbd/search_films \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```