# Movietickets — 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.

> Find movie showtimes and theaters near you, browse now playing and coming soon films, and get detailed movie information including ratings and schedules. Plan your movie nights by checking availability across theaters and viewing comprehensive movie metadata all in one place.

**Category:** Entertainment | **Website:** [movietickets.com/](https://movietickets.com/) | **Docs:** [parse.bot/marketplace/6442e77c-a2a5-4044-a059-35489ed9bb58/movietickets-com-api](https://parse.bot/marketplace/6442e77c-a2a5-4044-a059-35489ed9bb58/movietickets-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-movietickets-com-api-6442e77c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_coming_soon_movies

Retrieves movies coming soon to theaters. Returns an array of upcoming movie summaries including IDs, slugs, titles, poster URLs, and Rotten Tomatoes scores.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-movietickets-com-api-6442e77c/get_coming_soon_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_movie_calendar

Returns available showtime dates for a specific movie near a given zip code. The returned dates (YYYY-MM-DD strings) are used with get_movie_showtimes to retrieve actual showtime listings. Requires both the movie slug and movie_id from get_now_playing_movies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_id` | string | Yes | The numeric Fandango movie ID (from get_now_playing_movies or get_coming_soon_movies results). |
| `slug` | string | Yes | The URL slug for the movie title (from get_now_playing_movies results, e.g. 'scary-movie-2026'). |
| `zip_code` | string | Yes | 5-digit US zip code to check availability for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-movietickets-com-api-6442e77c/get_movie_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"movie_id":"<string>","slug":"<string>","zip_code":"<string>"}'
```

### get_movie_details

Returns comprehensive details for a specific movie by its ID, including images at multiple sizes, cast and crew IDs, genres, runtime in minutes, MPAA rating, full synopsis, release date, and trailer metadata. The movie_id is obtained from get_now_playing_movies or get_coming_soon_movies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_id` | string | Yes | The numeric Fandango movie ID (from get_now_playing_movies or get_coming_soon_movies results). |

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

### get_movie_scores

Returns Rotten Tomatoes critic and audience scores for a specific movie. Includes critic score, audience score, certified fresh status, and a link to the Rotten Tomatoes page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_id` | string | Yes | The numeric Fandango movie ID (from get_now_playing_movies or get_coming_soon_movies results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-movietickets-com-api-6442e77c/get_movie_scores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"movie_id":"<string>"}'
```

### get_movie_showtimes

Returns detailed showtimes for a specific movie grouped by theater for a given date and zip code. Each theater includes format variants (Standard, IMAX, Dolby, etc.), amenity details, and individual showtime entries with ticketing URLs. The date parameter should come from get_movie_calendar showtimeDates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | The date for showtimes in YYYY-MM-DD format (from get_movie_calendar showtimeDates). |
| `movie_id` | string | Yes | The numeric Fandango movie ID (from get_now_playing_movies or get_coming_soon_movies results). |
| `zip_code` | string | Yes | 5-digit US zip code for theater lookup. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-movietickets-com-api-6442e77c/get_movie_showtimes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","movie_id":"<string>","zip_code":"<string>"}'
```

### get_now_playing_movies

Retrieves all movies currently showing in theaters. Returns an array of movie summaries including IDs, slugs, titles, poster URLs, and Rotten Tomatoes scores. Use the returned movie_id and slug to call get_movie_details, get_movie_scores, or get_movie_calendar.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-movietickets-com-api-6442e77c/get_now_playing_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_theaters_near_location

Returns a list of theaters near a given US zip code, including theater name, street address, city/state/zip, distance from the zip code, and whether concession ordering is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | Yes | 5-digit US zip code to search near (e.g. 10001). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-movietickets-com-api-6442e77c/get_theaters_near_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zip_code":"<string>"}'
```