Feiertage- API
Frage Feiertage für 100+ Länder und beliebige Jahre in einem einzigen API-Aufruf ab. Vollständig lokale Berechnung — keine externen Datenquellen, keine Rate-Limit-Überraschungen.
Noch keinen API-Key?
Melde dich an, um API-Keys zu erstellen und zu verwalten.
Integrationsleitfaden
Snippet kopieren, deinen API-Key einsetzen, ausführen. Funktioniert in jedem HTTP-Client — Beispiele unten in cURL, JavaScript und Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringerforderlichISO 3166-1 alpha-2 country code US
yearintegeroptional4-digit year (defaults to current year) 2026
curl -X GET "https://www.apipick.com/api/holidays" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "Holidays retrieved successfully",
"data": {
"country": "US",
"country_name": "United States",
"year": 2026,
"total": 11,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day"
},
{
"date": "2026-01-19",
"name": "Martin Luther King Jr. Day"
},
{
"date": "2026-02-16",
"name": "Presidents' Day"
},
{
"date": "2026-05-25",
"name": "Memorial Day"
},
{
"date": "2026-07-03",
"name": "Independence Day (observed)"
},
{
"date": "2026-09-07",
"name": "Labor Day"
},
{
"date": "2026-10-12",
"name": "Columbus Day"
},
{
"date": "2026-11-11",
"name": "Veterans Day"
},
{
"date": "2026-11-26",
"name": "Thanksgiving Day"
},
{
"date": "2026-12-25",
"name": "Christmas Day"
}
]
},
"credits_used": 1,
"remaining_credits": 99
}Gebaut für reale Terminplanung
HR-Planung
Schließe Feiertage automatisch aus, wenn du Urlaubskontingente, Lohnzyklen und Schichtpläne über mehrere Länder hinweg berechnest.
Handelskalender
Überspringe handelsfreie Tage in Finanzmodellen und Backtests. Erkenne Bankfeiertage, die Settlement- und Clearing-Fenster betreffen.
Logistik-ETAs
Berechne akkurate Lieferprognosen, indem du Feiertage in Ursprungs-, Transit- und Zielland automatisch überspringst.
n8n-Automatisierung
Binde die API in n8n- oder Zapier-Workflows ein, um zeitkritische Aktionen zu steuern — verschicke an nationalen Feiertagen keine E-Mails oder Berichte.
Alternative zu HolidayAPI & Nager.Date
Daten zum laufenden Jahr, Planung für künftige Jahre und ein Produktions-SLA — ohne die Jahressperre der kostenlosen Stufe oder das Zuverlässigkeitsrisiko eines Community-Projekts.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Kostenlose Stufe | Nur Vorjahr | Kostenlos (kein SLA) | 100 Credits bei Registrierung |
| Daten zum laufenden Jahr | Nur Bezahlplan | ✓ | ✓ |
| Daten zu künftigen Jahren | Nur Bezahlplan | ✓ (eingeschränkt) | ✓ bis zu +10 Jahre |
| Historische Daten (ab 1900) | Nur Bezahlplan | Teilweise | ✓ ab 1900 |
| Produktions-SLA | Nur Bezahlpläne | ✗ Community-Projekt | ✓ |
| Abgedeckte Länder | ~100 | ~110 | 100+ |
| Keine Kreditkarte zum Start | ✗ | ✓ | ✓ |
| Verfallen Credits / Anfragen? | Jahresplan | N/A | Verfallen nie |
| Bereit für KI-Agenten / LLMs | Teilweise | Teilweise | ✓ Natives JSON |
Die Falle der kostenlosen HolidayAPI-Stufe
Der kostenlose Plan von HolidayAPI ist bewusst auf nur das vorherige Kalenderjahr beschränkt. Du musst Feiertage für das laufende Jahr nachschlagen oder vorausschauend Urlaubspläne für 2027 erstellen? Dann musst du auf einen Bezahlplan upgraden. Für jeden Planungs- oder Automatisierungs-Anwendungsfall macht das die kostenlose Stufe vom ersten Tag an praktisch nutzlos.
Das Zuverlässigkeitsrisiko von Nager.Date
Nager.Date ist ein community-gepflegtes Open-Source-Projekt — kostenlos nutzbar, aber mit keinem Uptime-SLA, keinem Support-Vertrag und keiner Garantie für fortlaufende Verfügbarkeit. Teams, die Lohnabrechnungssysteme oder Logistik-Pipelines darauf aufgebaut haben, wurden von unerwarteten Ausfällen oder Abkündigungen kalt erwischt. Gut für Prototyping; nicht für die Produktion.
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
| data.country | string | ISO-3166-1-alpha-2-Ländercode (Großbuchstaben) |
| data.country_name | string | Vollständiger englischer Name des Landes |
| data.year | integer | Das abgefragte Kalenderjahr |
| data.total | integer | Anzahl der Feiertage im Jahr |
| data.holidays | array | Liste von Feiertags-Objekten, nach Datum sortiert |
| data.holidays[].date | string | Feiertagsdatum im Format YYYY-MM-DD |
| data.holidays[].name | string | Offizieller Name des Feiertags |
| credits_used | integer | Für diese Anfrage abgezogene Credits |
| remaining_credits | integer | Verbleibende Credits in deinem Account |
Rate-Limits
Die Drosselung erfolgt pro API-Key, gleitendes 60-Sekunden-Fenster. Beim Erreichen des Limits bekommst du ein sauberes 429 mit Retry-After-Header.
120req/min
Pro API-Key, pro Endpunkt. Gleitendes 60-Sekunden-Fenster.
3concurrent
Maximale gleichzeitige laufende Anfragen pro API-Key.
X-RateLimit-LimitMaximal zulässige Anfragen pro MinuteX-RateLimit-RemainingVerbleibende Anfragen im aktuellen FensterX-RateLimit-ResetSekunden bis zum Zurücksetzen des aktuellen FenstersRetry-AfterSekunden Wartezeit vor erneutem Versuch (nur bei 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Häufig gestellte Fragen
F: Welche Länder werden unterstützt?
A: 100+ Länder über die Open-Source-Bibliothek python-holidays (vacanza). Dazu gehören die USA, Großbritannien, Deutschland, Frankreich, Japan, China, Australien, Kanada, Indien, Brasilien und der Großteil von Europa, Asien, Lateinamerika und Afrika. Verwende einen gültigen ISO-3166-1-alpha-2-Code (z. B. US, GB, DE).
F: Wie weit zurück und in die Zukunft kann ich abfragen?
A: Du kannst jedes Jahr ab 1900 bis zu 10 Jahre in der Zukunft abfragen. Historische Feiertage werden auf Basis der damals geltenden Regeln berechnet, sodass die Ergebnisse die tatsächlichen historischen Begehungen widerspiegeln und nicht die heutigen Regeln rückwärts projiziert.
F: Sind regionale Feiertage / Feiertage einzelner Bundesländer enthalten?
A: Dieser Endpunkt liefert ausschließlich nationale Feiertage. Bundesland-, provinz- oder regionenspezifische Begehungen (z. B. US-bundesstaatliche Feiertage, deutsche Länder-Feiertage) sind in der Standardantwort nicht enthalten. Kontaktiere uns, wenn du Feiertagsdaten auf Subdivisionsebene benötigst.
F: Können KI-Agenten diese API als Tool nutzen?
A: Ja. Der Endpunkt nimmt zwei Query-Parameter (country und year) entgegen und liefert ein strukturiertes JSON-Array — unkompliziert als Funktions-Tool für OpenAI, Claude, LangChain oder ein beliebiges Agenten-Framework zu definieren. Ideal für Planungs-Agenten, die über Arbeitstage in mehreren Ländern schlussfolgern müssen.
Feiertage in Claude Code & KI-Agenten nutzen
Installiere den offiziellen Claude-Code-Skill, um Feiertage für 100+ Länder direkt in deinem KI-Coding-Agenten abzufragen — sortierte Daten, offizielle Namen und Anzahl per natürlicher Sprache.
Frag deinen KI-Agenten ganz natürlich
Kompatible Plattformen
Claude-Code-Skill für die APIpick Public Holidays API
Liefert nach Datum sortierte Feiertagslisten mit offiziellen englischen Namen und Gesamtzahlen für 100+ Länder. Unterstützt Jahre von 1900 bis 10 Jahre voraus.