comingsoon.it APIcomingsoon.it ↗
Access Italian movie showtimes, theater listings, box office rankings, and film metadata from ComingSoon.it via a structured JSON API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/bcb56aee-e6e5-4a60-9815-1f4e7fb5eb8e/get_cities_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the full list of Italian cities and provinces that have cinemas listed on ComingSoon.it, including the number of movies currently showing in each city.
No input parameters required.
{
"type": "object",
"fields": {
"cities": "array of city objects with name, slug, url, and movie_count"
},
"sample": {
"data": {
"cities": [
{
"url": "https://www.comingsoon.it/cinema/l-aquila/",
"name": "L'Aquila",
"slug": "l-aquila",
"movie_count": 12
},
{
"url": "https://www.comingsoon.it/cinema/roma/",
"name": "Roma",
"slug": "roma",
"movie_count": 45
}
]
},
"status": "success"
}
}About the comingsoon.it API
The ComingSoon.it API exposes 8 endpoints covering Italian cinema data: city-level showtime listings, theater details with geo coordinates, full movie metadata, and weekly box office rankings. Use get_showtimes_for_movie_in_city to find every screening of a specific film across theaters in a given city, or get_box_office_italy to retrieve current Italian box office rankings with weekend and total gross revenue figures.
City and Theater Discovery
get_cities_list returns every Italian city and province with active cinema listings on ComingSoon.it, including a movie_count per city. Each city object includes a slug field (e.g. roma, milano, l-aquila) that drives all other city-scoped endpoints. From there, get_theaters_in_city resolves the full theater roster for any city slug, returning each theater's id, slug, name, url, and address — the inputs needed by get_theater_details.
Showtimes and Now-Playing Data
get_movies_in_city lists every film currently showing in a given city, returning movie id, title, and url. Passing a movie_id and city_slug to get_showtimes_for_movie_in_city returns per-theater screening schedules, including hall details and showtime arrays. get_movies_now_playing provides a paginated national view, sortable by theaters (number of cinemas showing the film) or rating (audience score), with fields like genre, release_date, director, and poster on each result.
Movie and Theater Detail
get_movie_details returns structured metadata for a specific film: actor array, director, genre, description (plot synopsis), and an extended_metadata object with additional page-level fields. Both movie_id and movie_slug are required inputs. get_theater_details complements this with a geo object (latitude/longitude), a full PostalAddress block, and a films_now_showing array for that venue.
Box Office
get_box_office_italy returns the current Italian box office table with rank, weekend_gross, total_gross, and screens for each entry, alongside a movie object containing id, slug, title, url, and poster. No additional parameters are required.
- Build a cinema finder app that maps Italian theaters using
geocoordinates andPostalAddressdata fromget_theater_details - Track Italian box office performance week-over-week using
weekend_grossandtotal_grossfromget_box_office_italy - Display showtimes for a specific film across all cinemas in Rome or Milan using
get_showtimes_for_movie_in_city - Populate a now-playing widget sorted by popularity (number of screens) using
get_movies_now_playingwithsort=theaters - Enrich a film database with Italian-market metadata (cast, synopsis, genre) via
get_movie_details - Generate city-by-city cinema coverage reports using
movie_countfromget_cities_list - Alert users when a specific movie opens in their city by monitoring
get_movies_in_cityfor new entries
| 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 ComingSoon.it offer an official developer API?+
What does `get_showtimes_for_movie_in_city` return, and how do I use it?+
city_slug and movie_id, each containing theater_name, theater_url, address, and a screenings array with hall and schedule details. You get both inputs from prior calls: city_slug from get_cities_list and movie_id from get_movies_in_city.Does the API cover future release schedules or only currently showing films?+
Is user review text or individual review scores available?+
get_movie_details returns an audience rating value and get_movies_now_playing includes a rating field, but individual user review text is not exposed. You can fork this API on Parse and revise it to add a review-fetching endpoint.Does pagination work the same across all list endpoints?+
get_movies_now_playing exposes a page parameter. get_cities_list, get_movies_in_city, get_theaters_in_city, and get_box_office_italy return their full result sets in a single response without pagination controls.