mymovies.it APImymovies.it ↗
Access Italian cinema showtimes, movie details, box office rankings, and cast data from MyMovies.it via 8 structured JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/4bbd1d1d-c34d-4ba2-b586-b1492fe3aaec/search_movies?query=Oppenheimer' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for movies by title on MyMovies.it. Returns matching movies with title, year, slug, and URL.
| 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.it 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.
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.
- 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 | 250 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.