# Frankfurt Theater

> Spielplan der Frankfurter Bühnen — aggregierte Vorstellungen, Karten und Verfügbarkeiten von 40 Häusern in Frankfurt am Main, kuratiert nach Tag.

Source: https://github.com/boredland/museumsufer
License: Application code MIT. Performance data aggregated from public theater sources.

This site provides a JSON API for querying theater performances in Frankfurt am Main, Germany.

## API

Base URL: https://frankfurt.ins.theater

### Day overview

GET /api/day?date=YYYY-MM-DD
Returns: { date, performances[] } — every performance scheduled on that date with show, theater, time, venue_room, status (available|sold_out|cancelled), price_min, price_max, ticket_url.

### Theaters

GET /api/theaters
Returns the directory of theaters (slug, name, address, lat, lon, website_url).

GET /api/theater/{slug}
Returns one theater plus its upcoming performances (next 60 days).

### Performances

GET /api/performances?from=YYYY-MM-DD&to=YYYY-MM-DD&theater={slug}
Paginated performance listing. `from`/`to` default to today / today+14, max range 60 days.

GET /api/performance/{id}
Single performance + its show + its theater.

### Calendar feeds

GET /feed.ics — next 14 days, all theaters
GET /theater/{slug}/feed.ics — single theater
GET /event/{id}/feed.ics — single performance

## Optional

- API documentation: https://frankfurt.ins.theater/api/docs
- OpenAPI spec: https://frankfurt.ins.theater/api/docs/openapi.json
- Source: https://github.com/boredland/museumsufer

## Notes

- Content (show titles, subtitles) is in German
- Dates use ISO 8601 (YYYY-MM-DD); times are 24h HH:MM in Europe/Berlin
- Performances list horizon: from today to ~60 days out
- Data refreshes hourly between 09:00 and 21:00 Europe/Berlin via a GitHub Action that regenerates the bundled scrape data and redeploys the worker
- Sold-out performances expose status="sold_out" with no price; cancelled performances expose status="cancelled"