Feiertage-API
Kostenlose JSON-API für Feiertagsdaten. 199 Länder, 6 Sprachen, 2024-2030. Kein API-Schlüssel erforderlich.
Endpunkte
/api/v1/holidays Gesetzliche Feiertage für ein bestimmtes Land und Jahr abrufen.
Parameter
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
country | Ja | ISO 3166-1 Alpha-2-Ländercode (z. B. TR, US, DE) |
year | Ja | Jahr zwischen 2024-2030 |
type | Nein | Nach Typ filtern: public, bank, observance, religious |
lang | Nein | Sprache: en, tr, de, es, fr, pt (Standard: en) |
Beispiel
https://holidaycalendar.pages.dev/api/v1/holidays?country=TR&year=2026&lang=tr Antwort
{
"holidays": [
{
"date": "2026-01-01",
"name": "Yılbaşı",
"type": "public"
},
{
"date": "2026-03-19",
"name": "Ramazan Bayramı Arifesi",
"type": "public"
}
],
"meta": {
"country": "TR",
"year": 2026,
"total": 16,
"types": { "public": 16 }
}
} /api/v1/countries Alle unterstützten Länder mit Codes, Namen und Kontinent auflisten.
Parameter
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
lang | Nein | Sprache für Ländernamen (Standard: en) |
Beispiel
https://holidaycalendar.pages.dev/api/v1/countries?lang=en /api/v1/calendar/[country].ics Eine ICS-Kalenderdatei für ein Land herunterladen. Als Abonnement-URL in Kalender-Apps verwenden.
Parameter
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
year | Nein | Jahr (Standard: aktuelles Jahr) |
lang | Nein | Sprache für Feiertagsnamen (Standard: en) |
Beispiel
https://holidaycalendar.pages.dev/api/v1/calendar/TR.ics?year=2026&lang=tr Schnellstart
Kein API-Schlüssel, keine Registrierung. Senden Sie einfach eine HTTP-GET-Anfrage.
const res = await fetch( 'https://holidaycalendar.pages.dev/api/v1/holidays?country=US&year=2026' ); const data = await res.json(); console.log(data.holidays);
import requests
r = requests.get(
'https://holidaycalendar.pages.dev/api/v1/holidays',
params={'country': 'US', 'year': 2026}
)
holidays = r.json()['holidays'] Details
Alle Endpunkte liefern JSON mit UTF-8-Kodierung. Der ICS-Endpunkt liefert text/calendar.
Antworten enthalten Cache-Control-Header (24 Std.). Feiertagsdaten ändern sich innerhalb eines Jahres selten.
Cross-Origin-Anfragen werden unterstützt. Rufen Sie die API direkt aus Browser-JavaScript auf.
Keine festen Ratenlimits bei angemessener Nutzung. Bitte cachen Sie Antworten auf Ihrer Seite für stark frequentierte Apps.
Häufig gestellte Fragen
Ist die API kostenlos?
Ja. Vollständig kostenlos, ohne API-Schlüssel, ohne Registrierung und ohne Nutzungslimits bei angemessener Nutzung.
Welche Datenformate sind verfügbar?
JSON für die Feiertage- und Länder-Endpunkte, ICS (iCalendar) für Kalender-Feeds. Alle Texte sind UTF-8-kodiert.
Wie viele Länder werden unterstützt?
199 Länder und Gebiete auf 6 Kontinenten, mit Daten von 2024 bis 2030.
Kann ich sie in kommerziellen Projekten verwenden?
Ja. Die API ist sowohl für private als auch kommerzielle Nutzung kostenlos. Wir freuen uns über einen Rückverweis, er ist aber nicht erforderlich.
Gibt es ein Ratenlimit?
Kein festes Ratenlimit, aber bitte cachen Sie Antworten für stark frequentierte Anwendungen. Antworten enthalten einen 24-Stunden-Cache-Control-Header.