# Atomtickets — 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, theater locations, and ticket prices in your area, then browse current and upcoming films with detailed information. Search for specific movies or theaters to compare showtimes and pricing across venues near you.

**Category:** Entertainment | **Website:** [atomtickets.com/](https://atomtickets.com/) | **Docs:** [parse.bot/marketplace/29e1f9a3-75f9-420a-b22e-8ab088b2df8a/atomtickets-com-api](https://parse.bot/marketplace/29e1f9a3-75f9-420a-b22e-8ab088b2df8a/atomtickets-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-atomtickets-com-api-29e1f9a3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_movie_details

Get full details for a specific movie including description, cast, director, ratings, trailer, and images. Uses structured data (JSON-LD) from the movie page. Both slug and movie_id are required and can be obtained from get_movies_in_theaters, get_movies_coming_soon, or search_movies_and_theaters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_id` | string | Yes | Numeric movie identifier (from get_movies_in_theaters or search_movies_and_theaters results). |
| `slug` | string | Yes | Movie URL slug (from get_movies_in_theaters or search_movies_and_theaters results). |

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

### get_movies_coming_soon

Get a list of upcoming movies not yet in theaters. May include special events and screenings. No input required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-atomtickets-com-api-29e1f9a3/get_movies_coming_soon \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_movies_in_theaters

Get a list of movies currently playing in theaters. Returns all movies shown on the Atom Tickets homepage with their titles, IDs, slugs, and URLs. No input required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-atomtickets-com-api-29e1f9a3/get_movies_in_theaters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_showtime_ticket_details

Get ticket types, prices, and metadata for a specific showtime. Showtime IDs are obtained from get_theater_details results (only future/purchasable showtimes have IDs). Returns stale_input if the showtime has expired or does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `showtime_id` | string | Yes | Showtime identifier obtained from get_theater_details results (showtimes[*].showtime_id for enabled showtimes only). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-atomtickets-com-api-29e1f9a3/get_showtime_ticket_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"showtime_id":"<string>"}'
```

### get_theater_details

Get details for a specific theater including current showtimes grouped by movie and format. Showtime IDs are available only for future showtimes that can be purchased. Past showtimes have empty showtime_id fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Theater URL slug (from get_theaters_near_location or search_movies_and_theaters results). |
| `theater_id` | string | Yes | Numeric theater identifier (from get_theaters_near_location or search_movies_and_theaters results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-atomtickets-com-api-29e1f9a3/get_theater_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","theater_id":"<string>"}'
```

### get_theaters_near_location

Get theaters near a specific location. Returns theaters with their names, IDs, slugs, and URLs. Uses a default location (Los Angeles) when location is omitted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | ZIP code or city name to search near. Omitting returns theaters near a default location (Los Angeles). |

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

### search_movies_and_theaters

Search for movies and theaters by keyword using the site's suggestion API. Returns matching movies and theaters. Results may vary by location; a default location (Los Angeles) is used internally.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string (e.g. movie title, theater name, or keyword). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-atomtickets-com-api-29e1f9a3/search_movies_and_theaters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```