Dni wolne od pracy API
Odpytuj o dni wolne od pracy dla ponad 100 krajów i dowolnego roku w jednym wywołaniu API. W pełni lokalne obliczenia — bez zewnętrznych źródeł danych, bez niespodzianek z limitami zapytań.
Nie masz klucza API?
Zaloguj się na swoje konto, aby tworzyć klucze API i nimi zarządzać.
Przewodnik integracji
Skopiuj fragment kodu, podmień swój klucz API, uruchom. Działa w dowolnym kliencie HTTP — przykłady poniżej w cURL, JavaScript i Pythonie.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringwymaganeISO 3166-1 alpha-2 country code US
yearintegeropcjonalne4-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
}Stworzone do rzeczywistego planowania
Planowanie w HR
Automatycznie wyłączaj dni wolne od pracy przy obliczaniu salda urlopów, cykli płacowych i grafików zmian w wielu krajach.
Kalendarze giełdowe
Pomijaj dni bez sesji w modelach finansowych i backtestach. Identyfikuj święta bankowe wpływające na okna rozliczeń i clearingu.
Szacowanie czasów dostaw
Obliczaj dokładne szacunki dostaw, automatycznie pomijając dni wolne w kraju nadania, tranzytu i docelowym.
Automatyzacja n8n
Podłącz do przepływów n8n lub Zapier, aby warunkować działania zależne od czasu — pomijaj wysyłkę e-maili lub raportów w święta narodowe.
Alternatywa dla HolidayAPI i Nager.Date
Dane z bieżącego roku, planowanie na przyszłe lata i produkcyjne SLA — bez blokady roku w darmowym poziomie i ryzyka niezawodności projektu społecznościowego.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Darmowy poziom | Tylko poprzedni rok | Darmowe (bez SLA) | 100 kredytów przy rejestracji |
| Dane z bieżącego roku | Tylko plan płatny | ✓ | ✓ |
| Dane z przyszłych lat | Tylko plan płatny | ✓ (ograniczone) | ✓ do +10 lat |
| Dane historyczne (od 1900) | Tylko plan płatny | Częściowo | ✓ od 1900 |
| Produkcyjne SLA | Tylko plany płatne | ✗ Projekt społecznościowy | ✓ |
| Objęte kraje | ~100 | ~110 | 100+ |
| Bez karty kredytowej na start | ✗ | ✓ | ✓ |
| Czy kredyty / żądania wygasają? | Plan roczny | N/A | Nigdy nie wygasają |
| Gotowe dla agentów AI / LLM | Częściowo | Częściowo | ✓ Natywny JSON |
Pułapka darmowego poziomu HolidayAPI
Darmowy plan HolidayAPI jest celowo ograniczony do wyłącznie poprzedniego roku kalendarzowego. Musisz sprawdzić dni wolne dla bieżącego roku lub zaplanować grafiki urlopów na 2027? Trzeba przejść na plan płatny. W każdym przypadku użycia związanym z planowaniem lub automatyzacją sprawia to, że darmowy poziom jest praktycznie bezużyteczny od pierwszego dnia.
Ryzyko niezawodności Nager.Date
Nager.Date to społecznościowo utrzymywany projekt open source — darmowy w użyciu, ale z brakiem SLA na dostępność, brakiem umowy wsparcia i brakiem gwarancji dalszej dostępności. Zespoły, które zbudowały na nim systemy płacowe lub pipeline'y logistyczne, dały się zaskoczyć nieoczekiwanym przestojom lub wycofaniu. W porządku do prototypowania; nie do produkcji.
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
| data.country | string | Kod kraju ISO 3166-1 alpha-2 (wielkie litery) |
| data.country_name | string | Pełna angielska nazwa kraju |
| data.year | integer | Odpytywany rok kalendarzowy |
| data.total | integer | Liczba dni wolnych od pracy w roku |
| data.holidays | array | Lista obiektów świąt posortowana według daty |
| data.holidays[].date | string | Data święta w formacie YYYY-MM-DD |
| data.holidays[].name | string | Oficjalna nazwa święta |
| credits_used | integer | Kredyty odjęte za to żądanie |
| remaining_credits | integer | Kredyty pozostałe na Twoim koncie |
Limity zapytań
Ograniczanie działa per klucz API, w przesuwnym oknie 60 sekund. Po przekroczeniu limitu otrzymasz czyste 429 z nagłówkiem Retry-After.
120req/min
Per klucz API, per endpoint. Przesuwne okno 60 sekund.
3concurrent
Maksymalna liczba jednoczesnych żądań w toku na klucz API.
X-RateLimit-LimitMaksymalna dozwolona liczba żądań na minutęX-RateLimit-RemainingPozostała liczba żądań w bieżącym oknieX-RateLimit-ResetSekundy do zresetowania bieżącego oknaRetry-AfterSekundy oczekiwania przed ponowieniem (tylko przy 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
}Najczęściej zadawane pytania
P: Które kraje są obsługiwane?
O: Ponad 100 krajów za pośrednictwem biblioteki open source python-holidays (vacanza). Obejmuje to USA, Wielką Brytanię, Niemcy, Francję, Japonię, Chiny, Australię, Kanadę, Indie, Brazylię oraz większość Europy, Azji, Ameryki Łacińskiej i Afryki. Użyj prawidłowego kodu ISO 3166-1 alpha-2 (np. US, GB, DE).
P: Jak daleko wstecz i w przód mogę odpytywać?
O: Możesz odpytywać dowolny rok od 1900 do 10 lat w przyszłość. Święta historyczne są obliczane na podstawie reguł obowiązujących w danym czasie, więc wyniki odzwierciedlają rzeczywiste historyczne obchody, a nie dzisiejsze reguły rzutowane wstecz.
P: Czy uwzględnione są święta regionalne/stanowe?
O: Ten endpoint zwraca wyłącznie krajowe dni wolne od pracy. Święta specyficzne dla stanów, prowincji lub regionów (np. święta stanowe w USA, święta niemieckich krajów związkowych) nie są uwzględnione w domyślnej odpowiedzi. Skontaktuj się z nami, jeśli potrzebujesz danych o świętach na poziomie jednostek administracyjnych.
P: Czy agenci AI mogą używać tego jako narzędzia?
O: Tak. Endpoint przyjmuje dwa parametry zapytania (country i year) i zwraca ustrukturyzowaną tablicę JSON — prosto zdefiniować go jako narzędzie funkcyjne dla OpenAI, Claude, LangChain lub dowolnego frameworku agentowego. Idealne dla agentów planujących, którzy muszą wnioskować o dniach roboczych w wielu krajach.
Używaj Public Holidays w Claude Code i agentach AI
Zainstaluj oficjalną umiejętność Claude Code, aby odpytywać o dni wolne od pracy dla ponad 100 krajów bezpośrednio w swoim agencie kodowania AI — posortowane daty, oficjalne nazwy i liczby za pomocą języka naturalnego.
Zapytaj swojego agenta AI w naturalny sposób
Kompatybilne platformy
Umiejętność Claude Code dla API Public Holidays od APIpick
Zwraca listy świąt posortowane według daty z oficjalnymi angielskimi nazwami i łącznymi liczbami dla ponad 100 krajów. Obsługuje lata od 1900 do 10 lat w przód.