yorck.de APIyorck.de ↗
Access film listings, showtimes, cinema details, specials, and membership data for all Yorck Kinogruppe cinemas in Berlin via 12 structured endpoints.
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'
Get films currently showing across all Yorck cinemas. Returns an array of film objects with title, runtime, slug, sessions, and other metadata.
No input parameters required.
{
"type": "object",
"fields": {
"films": "array of film objects currently playing, each containing sys.id and fields (title, slug, runtime, fsk, sessions, heroImage, etc.)"
},
"sample": {
"data": {
"films": [
{
"sys": {
"id": "HO00005646"
},
"fields": {
"fsk": 12,
"slug": "rose-film",
"title": "Rose",
"runtime": 93,
"vistaId": "HO00005646",
"mainLabel": "Drama",
"yorckPick": false,
"distributor": "Piffl",
"releaseDate": "2026-04-30"
}
}
]
},
"status": "success"
}
}About the yorck.de 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.
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.
- 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 | 250 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.