Everyman Cinema APIeverymancinema.com ↗
Access Everyman Cinema film schedules, showtimes, booking URLs, and venue data for all 50 UK locations via a simple REST API.
What is the Everyman Cinema API?
The Everyman Cinema API covers all 50 UK Everyman venues and exposes 3 endpoints for retrieving venue lists, daily showtimes, and upcoming film schedules. The get_schedule endpoint returns per-showtime data including booking URLs, occupancy rates, certificate, runtime, and genre tags for a specific venue and date. Use list_venues to map human-readable location names to the venue IDs that the other two endpoints require.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/dcafc810-4ed2-4f1c-9ae8-505914418810/list_venues' \ -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 everymancinema-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.
"""Walkthrough: Everyman Cinema SDK — browse venues, list scheduled movies, get showtimes."""
from parse_apis.everymancinema_com_api import EverymanCinema, ParseError
client = EverymanCinema()
# List all cinema venues across the UK
for venue in client.venues.list(limit=5):
print(venue.id, venue.name)
# Construct a specific venue and explore its upcoming movies
bury = client.venue(id="G0210")
movie = bury.movies.list(limit=1).first()
if movie:
print(movie.title, movie.certificate, movie.genres)
print("Scheduled on:", movie.scheduled_days[:3])
# Get today's showtimes for the same venue
showtime = bury.schedule.list(limit=1).first()
if showtime:
try:
print(showtime.title, showtime.starts_at, showtime.booking_url)
except ParseError as exc:
print(f"Error fetching showtime: {exc}")
# Get showtimes for a specific date
for st in bury.schedule.list(date="2026-07-14", limit=5):
print(st.title, st.starts_at, st.certificate)
print("exercised: venues.list / venue().movies.list / venue().schedule.list")
Returns all Everyman Cinema venues with their IDs and names. The venue ID is required by other endpoints to retrieve schedules and showtimes. Results are a static list of all 50 UK locations.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer",
"venues": "array of venue objects with id and name"
},
"sample": {
"data": {
"total": 50,
"venues": [
{
"id": "X11DP",
"name": "Altrincham"
},
{
"id": "X0712",
"name": "Baker Street"
},
{
"id": "G0210",
"name": "Bury St Edmunds"
}
]
},
"status": "success"
}
}About the Everyman Cinema API
Venue Discovery
Start with list_venues, which returns a static list of all 50 Everyman Cinema locations across the UK. Each venue object includes an id and name. The id values (e.g. G0210 for Bury St Edmunds, X11DP for Altrincham) are required parameters for both get_schedule and get_scheduled_movies, so this endpoint is the natural entry point for any integration.
Daily Showtimes
get_schedule accepts a theater_id (required) and an optional date in YYYY-MM-DD format, defaulting to today UTC. The response includes a films array where each showtime entry carries the movie title, start time, direct booking URL, occupancy rate, certificate, runtime, genres, and any tags (e.g. special screenings). The total_showtimes integer at the top level lets you quickly check whether a venue has any screenings on a given day without iterating the array.
Upcoming Film Schedules
get_scheduled_movies takes a theater_id and returns every film currently on the schedule at that venue across all upcoming dates — no need to loop day-by-day. Each movie object includes the full list of scheduled_dates, a synopsis, poster URL, certificate, runtime, and genres. The total_movies count covers the distinct film titles in the schedule window, not individual showtime slots.
Data Shape Notes
Occupancy rates and booking URLs are per-showtime fields returned only by get_schedule, not by get_scheduled_movies. The two schedule endpoints are complementary: use get_schedule when you need slot-level detail for a single date, and get_scheduled_movies when you need a venue's full upcoming film roster without iterating over dates.
The Everyman Cinema API is a managed, monitored endpoint for everymancinema.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when everymancinema.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 everymancinema.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 venue page showing today's showtimes with live booking links using
get_schedule - Display a 'coming soon' film list for a specific Everyman location using
get_scheduled_movies - Monitor occupancy rates across venues to identify popular screenings
- Aggregate showtimes from multiple venues to power a regional what's-on calendar
- Extract film metadata (certificate, runtime, genres) for a structured cinema database
- Send alerts when a new film appears on a venue's schedule by diffing
get_scheduled_moviesresponses over time
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Everyman Cinema have an official developer API?+
What does `get_schedule` return that `get_scheduled_movies` does not?+
get_schedule returns per-showtime fields including start times, direct booking URLs, and occupancy rates. get_scheduled_movies gives you each film's full set of scheduled dates, synopsis, and poster URL across the venue's upcoming window, but does not include individual slot times or occupancy data.Does the API cover all UK Everyman Cinema locations?+
list_venues returns all 50 current Everyman UK locations. Venues that open after the last API update may not appear until the venue list is refreshed. International locations are not in scope, as Everyman operates exclusively in the UK.Can I retrieve historical showtimes or past schedules?+
get_schedule defaults to today and accepts future dates, while get_scheduled_movies covers the upcoming booking window. You can fork this API on Parse and revise it to add a historical data endpoint if your use case requires past screening records.