Landmark Theatres APIlandmarktheatres.com ↗
Access Landmark Theatres movie listings, showtimes with ticketing URLs, occupancy data, and a full US theater directory via a simple REST API.
What is the Landmark Theatres API?
The Landmark Theatres API covers 3 endpoints that expose movie listings, dated showtimes, and a complete theater directory for Landmark Theatres locations across the United States. The get_showtimes endpoint returns individual screening times with direct ticketing URLs and occupancy rates. The list_theaters endpoint provides geocoordinates, screen counts, and time zones for every location.
curl -X GET 'https://api.parse.bot/scraper/016221b1-56cc-4f50-bec1-bb385802ef14/now_playing?theater_id=X00TM&theater_name=Kendall+Square' \ -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 landmarktheatres-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: Landmark Theatres SDK — discover theaters, browse movies, check showtimes."""
from parse_apis.landmark_theatres_api import LandmarkTheatres, TheaterNotFound
client = LandmarkTheatres()
# List all theater locations (total-items cap via limit=)
for theater in client.theaters.list(limit=5):
print(theater.name, theater.city, theater.state, f"({theater.screens} screens)")
# Construct a theater by ID and get its currently playing movies
palo_alto = client.theater(id="X00TM")
movie = palo_alto.now_playing(limit=1).first()
if movie:
print(movie.title, movie.rating, movie.runtime_minutes, movie.genres)
# Get showtimes for tomorrow at the same theater
if movie:
showtime_entry = palo_alto.showtimes(date="2026-06-12", limit=1).first()
if showtime_entry:
for screening in showtime_entry.showtimes:
print(screening.starts_at, screening.occupancy_rate, screening.ticketing_url)
# Typed error handling: catch a bad theater lookup
try:
bad = client.theater(id="INVALID_ID")
bad.now_playing(limit=1).first()
except TheaterNotFound as exc:
print(f"Theater not found: {exc}")
print("exercised: theaters.list / theater.now_playing / theater.showtimes / TheaterNotFound")
Get all movies currently playing or scheduled at a specific Landmark Theatre location. Returns full movie details including title, runtime, genres, cast, directors, synopsis, rating, poster URL, trailer URL, and scheduled dates. If neither theater_id nor theater_name is provided, returns results for a default location (Midtown Art Cinema).
| Param | Type | Description |
|---|---|---|
| theater_id | string | Direct theater ID (e.g. 'X00QM', 'X019B'). Overrides theater_name if provided. Get IDs from list_theaters endpoint. |
| theater_name | string | Theater name to search for (e.g. 'Kendall Square', 'Denver Pavilions'). Partial matching supported. |
{
"type": "object",
"fields": {
"total": "integer count of movies",
"movies": "array of movie objects with id, title, runtime_minutes, genres, directors, cast, synopsis, rating, advisory, poster_url, trailer_url, scheduled_dates, release_date",
"theater_id": "string theater identifier",
"theater_name": "string resolved theater name or ID"
},
"sample": {
"data": {
"total": 26,
"movies": [
{
"id": "313220",
"cast": [
"Chiwetel Ejiofor",
"Renate Reinsve",
"Mark Duplass"
],
"title": "Backrooms",
"genres": [
"Horror",
"Science fiction"
],
"rating": "R",
"advisory": "for language and some violent content/bloody images.",
"synopsis": "A strange doorway appears in the basement of a furniture showroom.",
"directors": [
"Kane Parsons"
],
"poster_url": "https://all.web.img.acsta.net/img/4e/34/4e34162d7489c977da291d752efb2b68.jpg",
"trailer_url": "https://m.boxoffice.media/QuickTime/393041_hd.mov",
"release_date": "2026-05-29T00:00:00.000Z",
"runtime_minutes": 111,
"scheduled_dates": [
"2026-06-10",
"2026-06-11",
"2026-06-12"
]
}
],
"theater_id": "X00QM",
"theater_name": "Midtown Art Cinema"
},
"status": "success"
}
}About the Landmark Theatres API
What the API Returns
The now_playing endpoint accepts either a theater_id (e.g. X00QM) or a partial theater_name string and returns an array of movie objects for that location. Each movie object includes title, runtime_minutes, genres, directors, cast, synopsis, rating, advisory, poster_url, and trailer_url, along with the scheduled dates for which the film is available. The endpoint resolves the theater and echoes back both theater_id and theater_name so lookups are unambiguous.
Showtimes Detail
The get_showtimes endpoint adds a date parameter (format YYYY-MM-DD, defaults to today) and returns a per-movie showtimes array. Each showtime entry includes the screening start time, a direct ticketing URL, occupancy rate, and accessibility tags (e.g. closed captions, audio description). Combining theater_id and date is the most precise query pattern; partial theater_name matching also works when the exact ID is not known.
Theater Directory
The list_theaters endpoint takes no inputs and returns all Landmark locations sorted alphabetically. Each theater object includes id, name, address, city, state, zip, phone, screens, time_zone, latitude, longitude, and description. The id values returned here are the theater_id strings used as input to the other two endpoints, so this endpoint is the natural starting point for building location-aware applications.
The Landmark Theatres API is a managed, monitored endpoint for landmarktheatres.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when landmarktheatres.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 landmarktheatres.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 local movie finder that surfaces what's playing near a user based on theater geocoordinates from
list_theaters. - Send daily showtime digest emails using
get_showtimeswith a specific date and theater, including direct ticketing links. - Display cast, synopsis, and poster images for now-playing films in a venue app using fields from
now_playing. - Aggregate occupancy rates across Landmark locations to identify high-demand screenings.
- Power a chatbot that answers 'what's playing tonight at the Kendall Square theater' using partial name matching.
- Map all Landmark locations with screen counts and time zones using
latitude,longitude, andtime_zonefromlist_theaters. - Filter currently playing films by genre or rating using the
genresandratingfields fromnow_playing.
| 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 Landmark Theatres have an official developer API?+
What does the `get_showtimes` endpoint return beyond screening times?+
runtime_minutes, rating, and poster_url so you don't need a separate call to display a full showtime card.Does the API cover historical showtimes or only current and upcoming dates?+
Can I retrieve showtimes for all theaters at once in a single call?+
now_playing and get_showtimes require a theater_id or theater_name and return results for one location at a time. You can retrieve the full theater list from list_theaters and iterate over the IDs. If you need a single bulk endpoint, you can fork this API on Parse and revise it to add a multi-theater query endpoint.Are there any known coverage limitations with the theater directory?+
list_theaters endpoint covers Landmark Theatres US locations as listed on their website. Theaters that have closed or are temporarily suspended may appear or be absent depending on how the source reflects their current status. No Canadian or international locations are included in the current directory.