# Mymovies — 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 movies and showtimes across Italian cinemas, find what's playing near you by city, and discover detailed information about films, cast members, and box office rankings. Browse upcoming releases and get comprehensive cinema details to plan your movie nights.

**Category:** Entertainment | **Website:** [mymovies.it/](https://mymovies.it/) | **Docs:** [parse.bot/marketplace/08273d53-c254-4ce3-87a5-cda6a3e3af8f/mymovies-it-api](https://parse.bot/marketplace/08273d53-c254-4ce3-87a5-cda6a3e3af8f/mymovies-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-mymovies-it-api-08273d53/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_box_office

Get current box office rankings in Italy, including daily earnings figures in euros. Returns the top 10 movies ranked by daily gross.

**Estimated cost:** Metered

_No parameters required._

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

### get_cinema_details

Get showtimes and details for a specific cinema venue. Returns the cinema name and current movie listings with showtimes for today. Some cinemas may have empty listings if they have no screenings today.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cinema_id` | string | Yes | Internal numeric ID of the cinema (from get_cinema_listings_by_city results) |
| `city_slug` | string | Yes | Lowercase city name (e.g. 'roma', 'milano') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mymovies-it-api-08273d53/get_cinema_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cinema_id":"<string>","city_slug":"<string>"}'
```

### get_cinema_listings_by_city

Get all cinemas in a specific Italian city with their IDs and URLs. Use the returned cinema IDs with get_cinema_details to retrieve showtimes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | Lowercase city name (e.g. 'roma', 'milano', 'napoli') |

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

### get_coming_soon

Get list of upcoming movies not yet released in Italian cinemas. Returns titles with brief info descriptions including genre and release date when available.

**Estimated cost:** Metered

_No parameters required._

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

### get_movie_cast

Get full cast and crew for a specific movie. Returns names and roles (when available). Includes actors, directors, producers, and other crew members.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Movie slug from URL path (e.g. 'oppenheimer') |
| `year` | string | Yes | Release year of the movie (e.g. '2023') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mymovies-it-api-08273d53/get_movie_cast \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### get_movie_details

Get detailed information for a specific movie including title, plot, rating, and metadata. Requires both the movie slug and release year (from search results or URL path). Returns basic metadata; for cast information use get_movie_cast.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Movie slug from URL path (e.g. 'oppenheimer', 'il-diavolo-veste-prada-2') |
| `year` | string | Yes | Release year of the movie (e.g. '2023') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mymovies-it-api-08273d53/get_movie_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### get_movies_in_cinema

Get list of movies currently playing in Italian cinemas. Returns all movies showing today across all Italian cinemas. Optionally filter by province code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `provincia` | string | No | Province code to filter movies (optional) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mymovies-it-api-08273d53/get_movies_in_cinema \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provincia":"<string>"}'
```

### search_movies

Full-text search over MyMovies.it movie database by title. Returns matching movies with title, year, slug, and URL. Results are ordered by relevance (rank). No pagination; the endpoint returns all matches in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for the movie title |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mymovies-it-api-08273d53/search_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```