hotcinema.co.il APIhotcinema.co.il ↗
Access Hot Cinema Israel movie listings, showtimes, cast details, and real-time seat availability across all theater locations via a simple REST API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e63f4d9e-3db1-45df-9a44-4147363c15bb/get_movies' \ -H 'X-API-Key: $PARSE_API_KEY'
Get a list of all movies currently showing in theaters. Scrapes the Hot Cinema homepage for all movie listings.
No input parameters required.
{
"type": "object",
"fields": {
"movies": "array of movie objects with movie_id and title"
},
"sample": {
"data": {
"movies": [
{
"title": "השטן לובשת פראדה 2",
"movie_id": "3595"
},
{
"title": "טופ גאן חגיגות 40 שנה: אהבה בשחקים + אהבה בשחקים מאווריק",
"movie_id": "3708"
}
]
},
"status": "success"
}
}About the hotcinema.co.il API
The Hot Cinema Israel API covers 4 endpoints that expose current movie listings, detailed film metadata, per-date showtimes across all theaters, and live seat availability. Starting with get_movies to retrieve active titles and their IDs, you can chain through to get_showtimes and get_available_seats to build a complete picture of what's playing, when, and how full each screening is.
Movie Listings and Details
get_movies returns an array of movie objects, each with a movie_id and title, representing everything currently showing at Hot Cinema locations. Pass that movie_id to get_movie_details to retrieve richer metadata: synopsis, director, cast (array of strings), duration, rating, original_title, a poster image URL, and an array of stills. The slug parameter on get_movie_details is optional — movie_id is the reliable key.
Showtimes
get_showtimes accepts a required movie_id and an optional date in DD/MM/YYYY format, defaulting to today if omitted. Each item in the returned showtimes array includes event_id, theater_id, theater_name, date, hour, screen_type, language, and an is_vip flag. This lets you filter by theater, language version, or screen format without additional requests.
Seat Availability
get_available_seats takes a site_id (the ticketing system identifier for the theater — for example, 1195 for Haifa or 1197 for Kfar Saba) and an event_id from get_showtimes. The response gives capacity, occupied_seats, and available_seats as integers, making it straightforward to check how full a specific screening is before presenting it to a user.
- Display a real-time cinema schedule widget showing all Hot Cinema showtimes for a given date with language and screen type filters.
- Alert users when available seats for a target screening drop below a threshold using
get_available_seats. - Build a movie discovery feed combining
poster,synopsis,cast, andratingfromget_movie_details. - Compare occupancy across theaters for the same film by looping
get_available_seatsover multiplesite_idvalues. - Track which films are currently showing by polling
get_moviesand diffing the returned title list over time. - Populate a mobile app's 'Now Playing' section with Hot Cinema-specific data including VIP screening flags and screen type.
| 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 Hot Cinema Israel offer an official developer API?+
What does `get_showtimes` return beyond just the time of a screening?+
event_id, theater_id, theater_name, date, hour, screen_type (e.g. standard vs. premium format), language, and an is_vip boolean. This is enough to distinguish between dubbed vs. subtitled screenings and VIP vs. regular auditoriums within a single response.Can I look up showtimes for a specific theater rather than all theaters at once?+
get_showtimes returns results for all theaters for a given movie_id and date — there is no theater_id filter parameter on that endpoint. You can filter the returned array client-side by theater_id or theater_name. You can fork the API on Parse and revise it to add a theater-scoped filter parameter if you need server-side filtering.