# Comingsoon — 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 box office rankings across Italy with access to detailed movie and theater information. Search now-playing films by city, compare showtimes at different cinemas, and discover what's trending at the Italian box office.

**Category:** Entertainment | **Website:** [comingsoon.it/](https://comingsoon.it/) | **Docs:** [parse.bot/marketplace/c19b3c0a-2469-4c20-bc38-6fa004599a6f/comingsoon-it-api](https://parse.bot/marketplace/c19b3c0a-2469-4c20-bc38-6fa004599a6f/comingsoon-it-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-comingsoon-it-api-c19b3c0a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_box_office_italy

Returns the current Italian box office rankings with movie details, weekend and total gross revenue, screen count, and weeks in release. Rankings are ordered by weekend performance.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-comingsoon-it-api-c19b3c0a/get_box_office_italy \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_cities_list

Returns all Italian cities and provinces that have cinemas listed on ComingSoon.it. Each city includes its slug for use in other endpoints. Movie counts may be null.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-comingsoon-it-api-c19b3c0a/get_cities_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_movie_details

Returns complete metadata for a specific movie from its schema.org JSON-LD structured data including cast, directors, description, rating, trailer URL, and extended metadata parsed from the page. Requires both movie_id and movie_slug from get_movies_now_playing or get_box_office_italy results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `movie_id` | string | Yes | Numeric movie ID from get_movies_now_playing or get_box_office_italy results (e.g. '68151'). |
| `movie_slug` | string | Yes | Movie URL slug from get_movies_now_playing or get_box_office_italy results (e.g. 'scary-movie'). |

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

### get_movies_in_city

Returns all movies currently showing in a given Italian city. The movie IDs returned are city-specific showtime IDs (idf), suitable for get_showtimes_for_movie_in_city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | City slug from get_cities_list results (e.g. 'roma', 'milano', 'torino'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-comingsoon-it-api-c19b3c0a/get_movies_in_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```

### get_movies_now_playing

Returns a paginated list of movies currently in Italian cinemas. Sortable by number of theaters showing the film or by audience rating. Returns movie ID and slug suitable for get_movie_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `sort` | string | No | Sort order for the listing. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-comingsoon-it-api-c19b3c0a/get_movies_now_playing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sort":"<string>"}'
```

### get_showtimes_for_movie_in_city

Returns showtimes for a specific movie in a specific city. Lists theaters showing the movie with hall names and schedule/price details. The movie_id is the city-specific idf value from get_movies_in_city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | City slug (e.g. 'roma', 'milano'). |
| `movie_id` | string | Yes | City-specific movie ID (idf) from get_movies_in_city results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-comingsoon-it-api-c19b3c0a/get_showtimes_for_movie_in_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>","movie_id":"<string>"}'
```

### get_theater_details

Returns full details for a specific cinema theater including postal address, geo coordinates, aggregate rating, and films currently showing. Requires city_slug, theater_slug, and theater_id from get_theaters_in_city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | City slug (e.g. 'roma'). |
| `theater_id` | string | Yes | Theater ID from get_theaters_in_city results (e.g. '467'). |
| `theater_slug` | string | Yes | Theater URL slug from get_theaters_in_city results (e.g. 'adriano-multisala'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-comingsoon-it-api-c19b3c0a/get_theater_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>","theater_id":"<string>","theater_slug":"<string>"}'
```

### get_theaters_in_city

Returns all cinema theaters in a given Italian city. Each theater includes an ID and slug for use with get_theater_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | City slug from get_cities_list results (e.g. 'roma', 'milano'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-comingsoon-it-api-c19b3c0a/get_theaters_in_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>"}'
```