Co 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.
What is the Co 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.
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'
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 hotcinema-co-il-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: Hot Cinema Israel SDK — browse movies, check showtimes, query seat availability."""
from parse_apis.Hot_Cinema_Israel_API import HotCinema, SiteId, MovieNotFound
client = HotCinema()
# List all currently showing movies (single-page, bounded by limit)
for movie in client.movies.list(limit=5):
print(movie.movie_id, movie.title)
# Drill into the first movie's full details
movie = client.movies.list(limit=1).first()
detail = movie.details()
print(detail.title, detail.director, detail.duration, detail.synopsis[:80])
# List showtimes for this movie (defaults to tomorrow)
for showtime in movie.showtimes.list(limit=3):
print(showtime.event_id, showtime.theater_name, showtime.hour, showtime.screen_type)
# Check seat availability at one theater
seats = showtime.seats(site_id=SiteId.KFAR_SABA)
print(seats.available_seats, seats.capacity)
# Typed error handling: attempt to fetch a non-existent movie
try:
bad = client.movies.get(movie_id="9999999")
except MovieNotFound as exc:
print(f"Movie not found: {exc.movie_id}")
print("exercised: movies.list / movies.get / movie.details / showtimes.list / showtime.seats")
Retrieve all movies currently showing across Hot Cinema Israel theaters. Returns a flat list of movie identifiers and titles scraped from the homepage. Each movie_id can be used with get_movie_details and get_showtimes.
No input parameters required.
{
"type": "object",
"fields": {
"movies": "array of movie objects each containing movie_id and title"
},
"sample": {
"data": {
"movies": [
{
"title": "התגלית",
"movie_id": "3592"
},
{
"title": "סינמה נוסטלגיה גריז",
"movie_id": "3029"
},
{
"title": "סולטיז הסרט",
"movie_id": "3730"
}
]
},
"status": "success"
}
}About the Co API
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.
The Co API is a managed, monitored endpoint for hotcinema.co.il — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hotcinema.co.il 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 hotcinema.co.il 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?+
- 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 | 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 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.