# Cinemark — 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 for Cinemark theater locations and movies, then browse showtimes and ticket prices to plan your movie outing. Get detailed information about available films across all US Cinemark locations to compare options and find the perfect showtime for you.

**Category:** Entertainment | **Website:** [www.cinemark.com/](https://www.cinemark.com/) | **Docs:** [parse.bot/marketplace/0509869f-b4a7-4456-9b22-235f9ad5760c/cinemark-com-api](https://parse.bot/marketplace/0509869f-b4a7-4456-9b22-235f9ad5760c/cinemark-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-cinemark-com-api-0509869f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_movie_details

Returns detailed information about a specific movie including synopsis, full cast, genres, trailer URL, and rating. The slug is obtained from the get_movies endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Movie URL slug from get_movies (e.g. the-odyssey, moana). |

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

### get_movies

Returns the Cinemark movie catalog. Without a status filter, returns all currently showing movies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Filter by movie status. Omitting returns now-showing movies. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cinemark-com-api-0509869f/get_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>"}'
```

### get_showtimes

Returns session-level showtimes for a specific theater. Each showtime includes movie name, session ID, date/time, format, and accessibility attributes. Identify the theater by slug (theater_id from get_theaters) or by display name (theater_name for fuzzy case-insensitive lookup). When theater_name matches multiple theaters, returns a disambiguation list instead of showtimes. Results include the numeric theaterId and movieId needed by get_ticket_prices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns today's showtimes. |
| `theater_id` | string | No | Theater path slug from get_theaters id field (e.g. va-fairfax/cinemark-fairfax-corner-and-xd). Either theater_id or theater_name is required. |
| `theater_name` | string | No | Theater display name for fuzzy case-insensitive lookup (e.g. Cinemark Fairfax Corner and XD). Either theater_id or theater_name is required. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cinemark-com-api-0509869f/get_showtimes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","theater_id":"<string>","theater_name":"<string>"}'
```

### get_theaters

Returns all US Cinemark theater locations. When a state filter is applied (and the result set is 20 or fewer), each theater includes full address and available format details fetched from its detail page. Without filter, returns basic info (name, city, state, URL slug) for all 300+ locations. The id field is the theater path slug used by get_showtimes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state` | string | No | Two-letter US state abbreviation to filter theaters (e.g. VA, TX, CA). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cinemark-com-api-0509869f/get_theaters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"<string>"}'
```

### get_ticket_prices

Returns ticket types and prices for a specific showtime session. All parameters are obtained from the get_showtimes response fields: theaterId, sessionId, movieId, and sessionDateTime.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_id` | string | Yes | Cinemark movie ID from get_showtimes movieId field (e.g. 108919). |
| `showtime_datetime` | string | Yes | Session datetime from get_showtimes sessionDateTime field (e.g. 2026-07-19T14:50:00). |
| `showtime_id` | string | Yes | Session ID from get_showtimes sessionId field (e.g. 306627). |
| `theater_id` | string | Yes | Numeric theater ID from get_showtimes theaterId field (e.g. 1111). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cinemark-com-api-0509869f/get_ticket_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"movie_id":"<string>","showtime_datetime":"<string>","showtime_id":"<string>","theater_id":"<string>"}'
```