Hari Libur Nasional API
Cari hari libur nasional untuk 100+ negara dan tahun apa pun dalam satu panggilan API. Komputasi sepenuhnya lokal — tanpa sumber data eksternal, tanpa kejutan rate-limit.
Belum punya API key?
Masuk ke akun Anda untuk membuat dan mengelola API key.
Panduan integrasi
Salin snippet, ganti API key kamu, jalankan. Bekerja di HTTP client mana pun — contoh di bawah dalam cURL, JavaScript, dan Python.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringwajibISO 3166-1 alpha-2 country code US
yearintegeropsional4-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
}Dibuat untuk Penjadwalan Dunia Nyata
Penjadwalan HR
Kecualikan hari libur nasional secara otomatis saat menghitung saldo cuti, siklus penggajian, dan jadwal shift di beberapa negara.
Kalender Bursa
Lewati hari non-perdagangan dalam model keuangan dan backtest. Identifikasi hari libur bank yang memengaruhi jendela settlement dan kliring.
ETA Logistik
Hitung estimasi pengiriman yang akurat dengan melewati hari libur di negara asal, transit, dan tujuan secara otomatis.
Otomasi n8n
Hubungkan ke alur kerja n8n atau Zapier untuk menggerbang tindakan sensitif-waktu — lewati pengiriman email atau laporan pada hari libur nasional.
Alternatif HolidayAPI & Nager.Date
Data tahun berjalan, perencanaan tahun mendatang, dan SLA produksi — tanpa kunci tahun free-tier atau risiko keandalan proyek komunitas.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Free tier | Hanya tahun sebelumnya | Gratis (tanpa SLA) | 100 kredit saat mendaftar |
| Data tahun berjalan | Hanya paket berbayar | ✓ | ✓ |
| Data tahun mendatang | Hanya paket berbayar | ✓ (terbatas) | ✓ hingga +10 tahun |
| Data historis (1900+) | Hanya paket berbayar | Sebagian | ✓ sejak 1900 |
| SLA produksi | Hanya paket berbayar | ✗ Proyek komunitas | ✓ |
| Negara yang dicakup | ~100 | ~110 | 100+ |
| Tanpa kartu kredit untuk memulai | ✗ | ✓ | ✓ |
| Kredit / request kedaluwarsa? | Paket tahunan | N/A | Tidak pernah kedaluwarsa |
| Siap AI agent / LLM | Sebagian | Sebagian | ✓ JSON Native |
Jebakan free-tier HolidayAPI
Paket gratis HolidayAPI sengaja dibatasi hanya untuk tahun kalender sebelumnya saja. Perlu mencari hari libur untuk tahun berjalan atau merencanakan jadwal cuti 2027? Kamu harus upgrade ke paket berbayar. Untuk use case penjadwalan atau otomasi apa pun, ini membuat free tier praktis tidak berguna sejak hari pertama.
Risiko keandalan Nager.Date
Nager.Date adalah proyek open-source yang dikelola komunitas — gratis dipakai tetapi dengan tanpa SLA uptime, tanpa kontrak dukungan, dan tanpa jaminan ketersediaan berkelanjutan. Tim yang membangun sistem penggajian atau pipeline logistik di atasnya pernah terjebak downtime tak terduga atau penghentian layanan. Cocok untuk prototipe; bukan untuk produksi.
Field Respons
| Field | Tipe | Deskripsi |
|---|---|---|
| data.country | string | Kode negara ISO 3166-1 alpha-2 (huruf besar) |
| data.country_name | string | Nama lengkap negara dalam bahasa Inggris |
| data.year | integer | Tahun kalender yang dikueri |
| data.total | integer | Jumlah hari libur nasional dalam tahun tersebut |
| data.holidays | array | Daftar objek hari libur yang diurutkan berdasarkan tanggal |
| data.holidays[].date | string | Tanggal hari libur dalam format YYYY-MM-DD |
| data.holidays[].name | string | Nama resmi hari libur |
| credits_used | integer | Kredit yang dipotong untuk request ini |
| remaining_credits | integer | Kredit yang tersisa di akun kamu |
Rate limit
Throttling berlaku per API key, jendela geser 60 detik. Jika melewati batas, kamu mendapat 429 yang rapi dengan header Retry-After.
120req/min
Per API key, per endpoint. Jendela geser 60 detik.
3concurrent
Maksimum request bersamaan yang sedang berjalan per API key.
X-RateLimit-LimitJumlah maksimum request yang diizinkan per menitX-RateLimit-RemainingRequest yang tersisa di jendela saat iniX-RateLimit-ResetDetik sampai jendela saat ini di-resetRetry-AfterDetik yang harus ditunggu sebelum mencoba lagi (hanya pada 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
}Pertanyaan yang Sering Diajukan
T: Negara mana saja yang didukung?
J: 100+ negara melalui pustaka open-source python-holidays (vacanza). Ini termasuk AS, Inggris, Jerman, Prancis, Jepang, Tiongkok, Australia, Kanada, India, Brasil, dan sebagian besar Eropa, Asia, Amerika Latin, dan Afrika. Gunakan kode ISO 3166-1 alpha-2 yang valid (mis. US, GB, DE).
T: Seberapa jauh ke belakang dan ke depan saya bisa mengkueri?
J: Kamu bisa mengkueri tahun apa pun dari 1900 hingga 10 tahun ke depan. Hari libur historis dihitung berdasarkan aturan yang berlaku pada saat itu, jadi hasil mencerminkan perayaan historis yang sebenarnya, bukan aturan hari ini yang diproyeksikan mundur.
T: Apakah hari libur regional/negara bagian termasuk?
J: Endpoint ini hanya mengembalikan hari libur nasional. Perayaan khusus negara bagian, provinsi, atau region (mis. hari libur negara bagian AS, hari libur Länder Jerman) tidak termasuk dalam respons default. Hubungi kami jika kamu butuh data hari libur tingkat subdivisi.
T: Bisakah AI agent menggunakan ini sebagai tool?
J: Bisa. Endpoint menerima dua parameter kueri (country dan year) dan mengembalikan array JSON terstruktur — mudah didefinisikan sebagai tool fungsi untuk OpenAI, Claude, LangChain, atau framework agent mana pun. Ideal untuk agent penjadwalan yang perlu menalar hari kerja di beberapa negara.
Gunakan Public Holidays di Claude Code & AI Agent
Instal Claude Code skill resmi untuk mengkueri hari libur nasional 100+ negara langsung di dalam AI coding agent kamu — tanggal terurut, nama resmi, dan jumlah lewat bahasa natural.
Tanyakan ke AI agent kamu secara natural
Platform yang kompatibel
Claude Code skill untuk API Public Holidays APIpick
Mengembalikan daftar hari libur terurut berdasarkan tanggal dengan nama resmi bahasa Inggris dan jumlah total untuk 100+ negara. Mendukung tahun dari 1900 hingga 10 tahun ke depan.