Grundsätze
- Nur GET, keine Anmeldung, kein Schlüssel. Basisadresse:
https://daten.alzuna.de - Alle Datenadressen senden
Access-Control-Allow-Origin: *– Aufrufe direkt aus dem Browser sind erlaubt. - Feldnamen englisch und stabil; Datum als
YYYY-MM-DD, Zeitpunkte als ISO 8601 in UTC. - Feiertage, Brückentage und Zuordnungen werden einen Tag zwischengespeichert (
Cache-Control: public, max-age=86400), die Ausschreibungsstatistik 15 Minuten. - Bitte höchstens etwa eine Anfrage pro Sekunde und Antworten bei Ihnen zwischenspeichern. Bei Missbrauch behalten wir uns Sperren vor.
Alle Endpunkte
Parameter
| Parameter | Werte | Fehler |
|---|---|---|
{year} im Pfad | 2024 bis 2035 | Andere Jahre: 404 |
land | Kennung aus Regionen (bayern), Kürzel (BY) oder de für nur bundesweite Einträge; ohne Angabe alle Länder | 400 mit {"error": …} |
tage | 1 bis 90 (Ausschreibungsstatistik, Standard 30) | Ungültiges wird zu 30 |
nach | tag, gewerk, region, art, alle (nur Statistik-CSV) | 400 |
Beispiele
# Feiertage 2027 in Bayern als JSON
curl -s "https://daten.alzuna.de/feiertage/2027.json?land=bayern"
# Alle Feiertage 2027 als CSV für die Tabellenkalkulation
curl -s -o feiertage-2027.csv "https://daten.alzuna.de/feiertage/2027.csv"
# Kalender abonnieren (Outlook, Google, Apple)
https://daten.alzuna.de/feiertage/2027.ics?land=hessen
# Brückentage 2027 in Nordrhein-Westfalen
curl -s "https://daten.alzuna.de/brueckentage/2027.json?land=nordrhein-westfalen"
# Ausschreibungen der letzten 7 Tage je Gewerk
curl -s "https://daten.alzuna.de/ausschreibungen/statistik.csv?tage=7&nach=gewerk"Antwort (gekürzt):
{
"dataset": "feiertage",
"licence": "CC-BY-4.0",
"attribution": "Quelle: Alzuna Daten (daten.alzuna.de)",
"generated": "2026-11-13T09:00:00.000Z",
"parameters": { "year": 2027, "land": "bayern" },
"count": 13,
"data": [
{ "date": "2027-01-01", "weekday": 5, "name": "Neujahr", "nationwide": true,
"regions": ["BW", "BY", …], "partialRegions": [], "note": null },
…
]
}