VOX Cinemas APIuae.voxcinemas.com ↗
Access VOX Cinemas UAE movie listings, showtimes, cinema locations, and film details via API. Filter by date, movie, or cinema across all UAE locations.
What is the VOX Cinemas API?
This API covers 5 endpoints for VOX Cinemas UAE, returning movie listings, detailed film metadata, cinema locations with coordinates, and showtimes across all UAE venues. The get_showtimes endpoint lets you filter by date, movie name, and cinema name, returning results grouped by film, location, and experience type such as IMAX, 4DX, or GOLD.
curl -X GET 'https://api.parse.bot/scraper/9e14b69a-e804-4059-b469-e85b8eeb5f51/get_movies?category=whatson' \ -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 uae-voxcinemas-com-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.
"""VOX Cinemas UAE — browse movies, cinemas, and showtimes."""
from parse_apis.vox_cinemas_uae_api import VOXCinemas, Category, MovieNotFound
client = VOXCinemas()
# List currently showing movies with the Category enum
for movie in client.moviesummaries.list(category=Category.WHATSON, limit=5):
print(movie.name, movie.content_rating, movie.runtime_minutes)
# Drill into the first movie's full details
summary = client.moviesummaries.list(category=Category.WHATSON, limit=1).first()
if summary:
detail = summary.details()
print(detail.name, detail.description[:80], detail.duration_minutes)
# Browse cinema locations
cinema = client.cinemasummaries.list(limit=1).first()
if cinema:
full = cinema.details()
print(full.name, full.city, full.maps_url)
# Get showtimes for a movie
try:
movie = client.movies.get(slug="disclosure-day")
for showtime in movie.showtimes(limit=3):
print(showtime.movie_name, showtime.duration, showtime.classification)
except MovieNotFound as exc:
print(f"Movie not found: {exc.slug}")
print("exercised: moviesummaries.list / details / cinemasummaries.list / cinema.details / movies.get / movie.showtimes")
Get list of currently showing movies at VOX Cinemas UAE, including title, language, genre, content rating, runtime, poster URL, and release date. Returns all movies in the 'Now Showing' category by default.
| Param | Type | Description |
|---|---|---|
| category | string | Movie category: 'whatson' for currently showing movies. |
{
"type": "object",
"fields": {
"total": "integer count of movies returned",
"movies": "array of movie objects with name, slug, code, movie_id, language, content_rating, poster_url, genres, release_date, runtime_minutes, subtitles, url",
"category": "string indicating the requested category"
},
"sample": {
"data": {
"total": 41,
"movies": [
{
"url": "https://uae.voxcinemas.com/movies/disclosure-day",
"code": "HO00015851",
"name": "Disclosure Day",
"slug": "disclosure-day",
"genres": [
"Thriller"
],
"language": "English",
"movie_id": "HO00013056",
"subtitles": null,
"poster_url": "https://uae.voxcinemas.com/images/NVW_Intl_MAIN_Digital1_Sht_RGB_UAE_en_1_2101968f04.png",
"release_date": "2026-06-10T00:00:00Z",
"content_rating": "PG13",
"runtime_minutes": 145
}
],
"category": "whatson"
},
"status": "success"
}
}About the VOX Cinemas API
Movie Listings and Details
The get_movies endpoint returns all currently showing films with fields including name, slug, description, language, content_rating, poster_url, and position. The slug values feed directly into get_movie_details, which expands each record to include genre, runtime, release_date, cast as an array of actor names, starring as a comma-separated string, director, language, and subtitles information. Movie slugs follow patterns like michael or athiradi-malayalam, reflecting multilingual programming across Arabic, English, Malayalam, Tamil, and other languages common in the UAE market.
Cinema Locations
The get_cinemas endpoint lists all VOX venues in the UAE, each with name, address, slug, and url. Passing a slug such as mall-of-the-emirates or burjuman to get_cinema_details returns the full location record: latitude, longitude, maps_url, description, and an experiences array listing the screen formats available at that venue — for example IMAX, 4DX, KIDS, THEATRE, or GOLD. Coordinates are included when available from the source, making it straightforward to plot locations on a map.
Showtimes
The get_showtimes endpoint is the most flexible in the set. Omitting the date parameter returns today's schedule; supplying a date string in YYYYMMDD format targets a specific day. Both the movie and cinema parameters accept partial, case-insensitive strings, so filtering for "emirates" will match Mall of the Emirates without requiring an exact name. The response includes an available_dates array with label and date_param values, useful for building a date-picker UI. Each movie object in the response carries classification, language, duration, and hero_image alongside a nested cinemas array that groups showtimes by venue and experience type.
The VOX Cinemas API is a managed, monitored endpoint for uae.voxcinemas.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when uae.voxcinemas.com 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 uae.voxcinemas.com 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 UAE cinema app showing now-playing films with poster images and content ratings from
get_movies - Display a cinema's available screen formats (IMAX, 4DX, GOLD) and GPS coordinates using
get_cinema_details - Power a showtime search tool filtered by date and cinema name via
get_showtimesparameters - Aggregate multilingual film schedules to surface Arabic, Malayalam, and Tamil showtimes separately
- Map all VOX UAE locations using
latitude,longitude, andmaps_urlfromget_cinema_details - Notify users of upcoming screenings for a specific film using partial-match movie filtering in
get_showtimes - Populate a film detail page with cast, director, genre, and release date from
get_movie_details
| 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 VOX Cinemas UAE have an official public developer API?+
What does `get_showtimes` return and how do the filters work?+
date is omitted) across all VOX UAE venues. Results are grouped by movie, then by cinema, then by experience type. The movie and cinema parameters both support partial, case-insensitive matching, so you can pass a fragment like "imax" or "dubai" rather than an exact venue name. The available_dates array in the response lists valid upcoming dates you can pass back as date_param.Is ticket booking or seat availability included?+
Does the API cover VOX Cinemas locations outside the UAE, such as Saudi Arabia or Egypt?+
Are movie runtime and subtitle language always present in `get_movie_details`?+
release_date, cast, and genre are similarly dependent on what the individual movie page exposes — some entries, particularly limited-run or upcoming titles, may have sparse metadata.