MyMovies APImymovies.it ↗
Access Italian cinema showtimes, movie details, box office rankings, and cast data from MyMovies.it via 8 structured JSON endpoints.
What is the MyMovies API?
The MyMovies.it API covers 8 endpoints that expose Italian cinema listings, movie metadata, showtimes, cast, and box office data from mymovies.it. You can look up what's currently playing by city using get_cinema_listings_by_city and get_cinema_details, retrieve full cast lists per film, check the Italian box office rankings with daily earnings figures, and browse upcoming releases — all in structured JSON.
curl -X GET 'https://api.parse.bot/scraper/4bbd1d1d-c34d-4ba2-b586-b1492fe3aaec/search_movies?query=oppenheimer' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mymovies-it-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: MyMovies.it SDK — search movies, check box office, find showtimes."""
from parse_apis.mymovies_it_api import MyMovies, CitySlug, NotFound
client = MyMovies()
# Search for a movie by title, get top result details
result = client.movies.search(query="oppenheimer", limit=3).first()
if result:
detail = result.details()
print(detail.title, detail.year, detail.meta_info)
# Box office: today's top earners in Italy
for entry in client.movies.box_office(limit=5):
print(entry.rank, entry.title, entry.earnings)
# Find cinemas in Roma and check showtimes at the first one
cinema = client.cinemas.by_city(city_slug=CitySlug.ROMA, limit=1).first()
if cinema:
for listing in cinema.listings.list(limit=5):
print(listing.movie, listing.showtimes)
# Browse cast for the top search result via sub-resource navigation
if result:
movie = client.movies.in_cinema(limit=1).first()
if movie:
for member in movie.cast_members.list(limit=3):
print(member.name, member.role)
# Typed error handling: catch NotFound on a bad movie detail lookup
try:
bad = client.movies.search(query="zzz_nonexistent_zzz", limit=1).first()
if bad:
bad.details()
except NotFound as exc:
print(f"not found: {exc}")
print("exercised: movies.search / details / box_office / cinemas.by_city / listings.list / cast_members.list")
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.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword for the movie title |
{
"type": "object",
"fields": {
"total": "integer count of results returned",
"results": "array of movie objects with title, year, slug, url"
},
"sample": {
"data": {
"total": 1,
"results": [
{
"url": "https://www.mymovies.it/film/2023/oppenheimer/",
"slug": "oppenheimer",
"year": "2023",
"title": "OPPENHEIMER"
}
]
},
"status": "success"
}
}About the MyMovies API
Movie Search and Details
The search_movies endpoint accepts a query string and returns an array of matching films with title, year, slug, and url. That slug and year pair is the key used across the API: pass them to get_movie_details to retrieve a plot summary, meta_info string (containing cast, genre, and duration in one field), and an average_rating. The same slug/year inputs power get_movie_cast, which returns a flat array of name and role pairs for the full cast and crew of a film.
Cinema Listings and Showtimes
get_movies_in_cinema lists films currently in Italian cinemas and accepts an optional provincia code to narrow results to a specific province. For venue-level detail, start with get_cinema_listings_by_city — supply a city_slug such as roma or milano and get back cinema names, internal IDs, and URLs. Feed a cinema_id and city_slug into get_cinema_details and the response includes a listings array where each entry holds a movie title and an array of showtimes in HH:MM format.
Box Office and Coming Soon
get_box_office returns Italy's current box office ranking array: each item carries a rank integer, title, slug, year, and an earnings string denominated in euros representing daily figures. get_coming_soon lists unreleased films with a brief info description per title, useful for tracking what's heading to Italian screens.
Data Scope and Freshness
All data is scoped to the Italian market. Movie pages on mymovies.it carry Italian-language plots and metadata. The meta_info field on get_movie_details is a raw string rather than a structured object, so parsing genre or duration requires client-side string handling. Rating availability depends on whether a film has been rated on the source site — average_rating may be absent for some titles.
The MyMovies API is a managed, monitored endpoint for mymovies.it — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mymovies.it changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mymovies.it API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a 'what's on tonight' app for Italian cinemas by querying
get_cinema_detailsfor showtime arrays per venue. - Track weekly Italian box office trends using
get_box_officedaily earnings figures. - Enrich a film database with Italian market data by combining
get_movie_detailsplot and rating withget_movie_castcredits. - Filter currently-playing Italian releases by province using the
provinciaparameter ofget_movies_in_cinema. - Power a release-calendar feature for Italian audiences using
get_coming_soonupcoming film listings. - Index all cinemas in a given Italian city and their current schedules by chaining
get_cinema_listings_by_citywithget_cinema_details. - Build cast and crew lookups for Italian-market film pages using
get_movie_castname and role pairs.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MyMovies.it have an official developer API?+
What does `get_cinema_details` return for showtimes, and how granular is the schedule?+
listings array where each entry contains a movie title string and a showtimes array of time strings in HH:MM format for the current day at that venue. The endpoint does not return multi-day schedules or ticket booking URLs — it reflects the same-day listing available on the cinema's page.Does the API return structured cast data like character names or headshots?+
get_movie_cast returns name and role strings per cast member. Character names and profile images are not currently exposed as distinct fields. You can fork this API on Parse and revise it to add an endpoint that surfaces additional cast detail if those fields become available on the source page.Can I get showtimes for a specific future date rather than today?+
How is `meta_info` structured in the `get_movie_details` response?+
meta_info is returned as a single concatenated string that may contain genre, duration, and cast mentions as they appear on the movie's page. It is not split into separate fields. Client-side parsing is needed if you want to extract individual components like duration or genre.