Yorck APIyorck.de ↗
Access film listings, showtimes, cinema details, specials, and membership data for all Yorck Kinogruppe cinemas in Berlin via 12 structured endpoints.
What is the Yorck API?
The Yorck Kinogruppe API covers 12 endpoints for Berlin's Yorck cinema chain, returning current and upcoming film listings, per-film showtimes, weekly schedules, detailed cinema profiles, and special programming. The get_now_playing endpoint returns film objects with title, runtime, FSK rating, sessions, and hero image for every film currently in rotation across all Yorck locations.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/00871d67-9999-4caf-a1be-0f1103045ccc/get_now_playing' \ -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 yorck-de-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: Yorck Kinos Berlin SDK — browse films, cinemas, and showtimes."""
from parse_apis.yorck_kinos_berlin_api import Yorck, Membership, ResourceNotFound
client = Yorck()
# Browse currently playing films — each carries slug, title, runtime.
for film in client.films.now_playing(limit=3):
print(film.title, f"({film.runtime} min)", film.mainLabel)
# Search films by title keyword, drill into the first match's showtimes.
film = client.films.search(query="drama", limit=1).first()
if film:
for session in film.showtimes(limit=3):
print(session.startTime, session.cinema_name, session.formats)
# List all cinemas, inspect the first one's details and schedule.
cinema = client.cinemas.list(limit=1).first()
if cinema:
print(cinema.name, cinema.district, cinema.numberOfAuditoriums)
for scheduled in cinema.showtimes(limit=2):
print(scheduled.title, scheduled.slug)
# Get membership subscription info (singleton resource).
membership = client.memberships.get()
print(membership.title, membership.benefit1Title)
# Typed error handling: catch a missing film gracefully.
try:
bad_film = client.film("nonexistent-slug-xyz")
list(bad_film.showtimes(limit=1))
except ResourceNotFound as exc:
print(f"Expected: {exc}")
print("exercised: films.now_playing / films.search / film.showtimes / cinemas.list / cinema.showtimes / memberships.get")
Get films currently showing across all Yorck cinemas. Returns the full roster of films in regular rotation with embedded session previews (next 3 showtimes per film). Each film carries a slug for drill-down via get_film_detail.
No input parameters required.
{
"type": "object",
"fields": {
"films": "array of film objects currently playing, each with id, title, slug, runtime, fsk, mainLabel, tagline, releaseDate, sessions"
},
"sample": {
"data": {
"films": [
{
"id": "HO00005737",
"fsk": 12,
"slug": "disclosure-day",
"title": "Disclosure Day",
"runtime": 120,
"tagline": "Spielberg's dystopian Thriller",
"sessions": [
{
"id": "1011-19276",
"formats": [
"DF"
],
"startTime": "2026-06-15T16:20:00+01:00",
"cinema_name": "Blauer Stern"
}
],
"mainLabel": "Science Fiction",
"releaseDate": "2026-06-10"
}
]
},
"status": "success"
}
}About the Yorck API
Film Data
get_now_playing and get_coming_soon each return arrays of film objects with fields including title, slug, runtime, fsk, releaseDate, and heroImage. For a specific film, get_film_detail adds director, cast, about (synopsis), poster, and embedded session data. search_films accepts a query string and performs case-insensitive substring matching against currently playing film titles, returning the same object shape as get_now_playing.
Showtimes and Schedules
get_film_showtimes accepts a required film_slug and an optional date parameter in YYYY-MM-DD format; it returns an array of session objects each containing startTime, formats, and cinema. get_cinema_showtimes works in the same way but takes a cinema_slug instead, returning all films and special events scheduled at that location on the requested date. get_week_schedule returns a full week of sessions across all cinemas, with an optional date parameter to shift the start of the window.
Cinemas and Specials
list_cinemas returns all Yorck cinema locations with fields for name, slug, address, district, shortDescription, accessibility, and auditorium count. get_cinema_detail expands on that with about, history, gallery, and transport info for a specific location identified by cinema_slug. For special programming, list_specials returns three separate arrays — active_specials, film_series, and festivals — and get_special_detail fetches a specific event by special_slug, including its assignedFilms and associated cinemas.
Membership
get_unlimited_membership_info returns structured data about the Yorck Unlimited subscription: title, subTitle, individual benefit fields (benefit1Title, benefit1Description, etc.), an unlimitedFootnote, a faQs array, and pricing details.
The Yorck API is a managed, monitored endpoint for yorck.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yorck.de 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 yorck.de 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 Berlin cinema guide that lists all currently playing films with runtimes and FSK ratings from
get_now_playing - Display a daily showtime schedule for a selected Yorck cinema using
get_cinema_showtimeswith a date filter - Show upcoming releases with release dates from
get_coming_soonto let users plan ahead - Render a film detail page with director, cast, synopsis, and session times via
get_film_detail - Surface festival and recurring film series listings using the
festivalsandfilm_seriesarrays fromlist_specials - Let users search currently playing films by keyword with
search_filmsfor a quick lookup feature - Present Yorck Unlimited membership benefits and FAQs from
get_unlimited_membership_infoalongside ticket purchase flows
| 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 yorck.de have an official public developer API?+
How does `get_film_showtimes` differ from `get_cinema_showtimes`?+
get_film_showtimes takes a film_slug and returns all sessions for that film across every Yorck cinema, optionally filtered by a date parameter. get_cinema_showtimes takes a cinema_slug and returns all films and special events at that single location for the requested date. They share the same session object shape with startTime, formats, and cinema fields.Does the API cover ticket purchasing or seat availability?+
Is the film search limited to currently playing titles?+
search_films matches against currently playing films only — the same set returned by get_now_playing. Films from get_coming_soon are not included in search results. You can fork the API on Parse and revise it to add a search endpoint covering the coming-soon catalog.Does the API include user reviews or ratings for films?+
title, director, cast, about, runtime, and fsk rating, but no user review text, aggregate scores, or external rating sources (such as IMDb scores) are returned. You can fork it on Parse and revise to add the missing endpoint.