Für Entwickler
Die Kalenderdaten hinter Kalendarien – als Schnittstelle.
Feiertage, Schulferien, Aktionstage, Saisons und Messetermine für ganz Deutschland. Gepflegt, mit Quellenangabe, und um das ergänzt, was in keiner Feiertagsliste steht: wie relevant ein Termin für welche Branche ist.
Was die Schnittstelle liefert
| Endpunkt | Zweck |
|---|---|
| /api/v1/events | Termine in einem Zeitraum – filterbar nach Bundesland, Art, Branche und Mindestrelevanz. |
| /api/v1/marketing-events | Nur Marketinganlässe, nach Relevanz sortiert – die Grundlage für Redaktionspläne. |
| /api/v1/holidays | Gesetzliche Feiertage je Bundesland und Jahr, inklusive der beweglichen. |
Antworten kommen als JSON, Datumsangaben als Kalendertage in UTC. Die vollständige Beschreibung mit allen Parametern steht in der API-Dokumentation.
Ein Aufruf, drei Zeilen
curl -H "X-API-Key: dein_schluessel" \
"https://kalendarien.de/api/v1/events?from=2027-01-01&to=2027-03-31®ion=DE-HH&min_score=70"Was der Zugang kostet
API
49 € / Monat
oder 490 € jährlich
Enthalten sind 50.000 Abrufe im Monat. Das reicht, um stündlich einen kompletten Jahreskalender zu holen – und noch etwas übrig zu behalten.
Der API-Zugang ist ein eigenständiges Produkt und keine Stufe der Tarifleiter: Er enthält keine Kalenderoberfläche, keine Kampagnen und keine KI-Funktionen. Wer beides braucht, findet die Abo-Tarife auf der Preisseite.
Häufige Fragen
Woher stammen die Daten?
Feiertage werden berechnet, auch die beweglichen. Schulferien werden wöchentlich gegen die Ferienordnungen der Länder abgeglichen und tragen den Vermerk, ob sie amtlich bestätigt oder noch vorläufig sind. Messetermine kommen von den Veranstaltern, Aktionstage und Marketinganlässe werden redaktionell gepflegt – jeder Eintrag mit Quelle, Datenqualität und Prüfdatum.
Was unterscheidet die Daten von einer Feiertagsliste?
Jeder Termin trägt sechs Relevanzwerte – Marketing, B2C, B2B, Social, E-Commerce und lokal – dazu einen empfohlenen Planungsvorlauf und die Zuordnung zu Branchen. Damit lässt sich nicht nur beantworten, wann etwas ist, sondern für wen es sich lohnt.
Wie wird authentifiziert?
Über einen API-Schlüssel im Header. Die Übergabe als Query-Parameter wird bewusst nicht unterstützt, weil der Schlüssel dabei in Server-Logs landet. Jeder Schlüssel hat zusätzlich ein Limit pro Minute.
Was passiert, wenn das Kontingent ausgeschöpft ist?
Die Schnittstelle antwortet mit Status 402 und einem Hinweis auf das Kontingent. Es gibt keine stille Drosselung und keine unbemerkten Zusatzkosten.
Kann ich die Daten zwischenspeichern?
Ja, das ist ausdrücklich erwünscht. Kalendertermine ändern sich selten; ein täglicher Abruf reicht für die meisten Anwendungen und schont dein Kontingent.