Resmi Tatiller API
100+ ülke ve herhangi bir yıl için resmi tatilleri tek bir API çağrısında sorgulayın. Tamamen yerel hesaplama — dış veri kaynağı yok, rate-limit sürprizi yok.
API key'iniz yok mu?
API key'lerinizi oluşturmak ve yönetmek için hesabınızda oturum açın.
Entegrasyon rehberi
Bir snippet kopyalayın, API anahtarınızı yerleştirin, çalıştırın. Herhangi bir HTTP istemcisinde çalışır — aşağıdaki örnekler cURL, JavaScript ve Python içindir.
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystringzorunluISO 3166-1 alpha-2 country code US
yearintegeristeğe bağlı4-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
}Gerçek Dünya Planlaması İçin Tasarlandı
İK Planlaması
Birden fazla ülkede izin bakiyelerini, bordro döngülerini ve vardiya çizelgelerini hesaplarken resmi tatilleri otomatik olarak hariç tutun.
Borsa Takvimleri
Finansal modellerde ve geriye dönük testlerde işlem yapılmayan günleri atlayın. Takas ve mutabakat pencerelerini etkileyen banka tatillerini belirleyin.
Lojistik Tahmini Varış Süreleri
Çıkış, transit ve varış ülkelerindeki tatilleri otomatik olarak atlayarak doğru teslimat tahminleri hesaplayın.
n8n Otomasyonu
Zaman açısından hassas işlemleri sınırlamak için n8n veya Zapier iş akışlarına entegre edin — ulusal tatillerde e-posta veya rapor göndermeyi atlayın.
HolidayAPI ve Nager.Date Alternatifi
Güncel yıl verisi, gelecek yıl planlaması ve bir üretim SLA'sı — ücretsiz katman yıl kilidi veya topluluk projesi güvenilirlik riski olmadan.
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| Ücretsiz katman | Yalnızca önceki yıl | Ücretsiz (SLA yok) | Kayıtta 100 kredi |
| Güncel yıl verisi | Yalnızca ücretli plan | ✓ | ✓ |
| Gelecek yıl verisi | Yalnızca ücretli plan | ✓ (sınırlı) | ✓ +10 yıla kadar |
| Tarihsel veriler (1900+) | Yalnızca ücretli plan | Kısmi | ✓ 1900'den itibaren |
| Üretim SLA'sı | Yalnızca ücretli planlar | ✗ Topluluk projesi | ✓ |
| Kapsanan ülkeler | ~100 | ~110 | 100+ |
| Başlamak için kredi kartı gerekmez | ✗ | ✓ | ✓ |
| Krediler / istekler sona erer mi? | Yıllık plan | N/A | Asla sona ermez |
| Yapay zeka ajanı / LLM'ye hazır | Kısmi | Kısmi | ✓ Yerel JSON |
HolidayAPI ücretsiz katman tuzağı
HolidayAPI'nin ücretsiz planı kasıtlı olarak yalnızca önceki takvim yılıyla sınırlıdır. Güncel yıl için tatilleri sorgulamanız veya 2027 izin çizelgeleri için önden plan yapmanız mı gerekiyor? Ücretli bir plana yükseltmeniz gerekir. Herhangi bir planlama veya otomasyon kullanım senaryosunda bu, ücretsiz katmanı ilk günden pratik olarak kullanışsız kılar.
Nager.Date güvenilirlik riski
Nager.Date topluluk tarafından yönetilen açık kaynaklı bir projedir — kullanımı ücretsiz ancak çalışma süresi SLA'sı yok, destek sözleşmesi yok ve süregelen erişilebilirlik garantisi yok şekilde. Bordro sistemlerini veya lojistik hatlarını bunun üzerine kurmuş ekipler beklenmedik kesintiler veya kullanımdan kaldırmalar nedeniyle zora düşmüştür. Prototip için uygun; üretim için değil.
Yanıt Alanları
| Alan | Tür | Açıklama |
|---|---|---|
| data.country | string | ISO 3166-1 alpha-2 ülke kodu (büyük harf) |
| data.country_name | string | Ülkenin İngilizce tam adı |
| data.year | integer | Sorgulanan takvim yılı |
| data.total | integer | Yıldaki resmi tatil sayısı |
| data.holidays | array | Tarihe göre sıralanmış tatil nesneleri listesi |
| data.holidays[].date | string | YYYY-MM-DD biçiminde tatil tarihi |
| data.holidays[].name | string | Tatilin resmi adı |
| credits_used | integer | Bu istek için düşülen kredi |
| remaining_credits | integer | Hesabınızda kalan kredi |
Rate limit'ler
Sınırlama, API anahtarı başına ve 60 saniyelik kayan pencere ile uygulanır. Sınıra ulaştığınızda Retry-After başlığıyla birlikte temiz bir 429 alırsınız.
120req/min
API anahtarı başına, endpoint başına. 60 saniyelik kayan pencere.
3concurrent
API anahtarı başına maksimum eşzamanlı işlemdeki istek sayısı.
X-RateLimit-LimitDakika başına izin verilen maksimum istek sayısıX-RateLimit-RemainingMevcut penceredeki kalan istek sayısıX-RateLimit-ResetMevcut pencere sıfırlanana kadarki saniyeRetry-AfterYeniden denemeden önce beklenecek saniye (yalnızca 429'da)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
}Sıkça Sorulan Sorular
S: Hangi ülkeler destekleniyor?
C: Açık kaynaklı python-holidays (vacanza) kütüphanesi aracılığıyla 100+ ülke. Buna ABD, Birleşik Krallık, Almanya, Fransa, Japonya, Çin, Avustralya, Kanada, Hindistan, Brezilya ve Avrupa, Asya, Latin Amerika ve Afrika'nın çoğu dahildir. Geçerli bir ISO 3166-1 alpha-2 kodu kullanın (ör. US, GB, DE).
S: Ne kadar geriye ve ileriye sorgulayabilirim?
C: 1900'den gelecekte 10 yıla kadar herhangi bir yılı sorgulayabilirsiniz. Tarihsel tatiller o dönemde yürürlükte olan kurallara göre hesaplanır, dolayısıyla sonuçlar bugünkü kuralların geriye yansıtılması yerine gerçek tarihsel kutlamaları yansıtır.
S: Bölgesel/eyalet tatilleri dahil mi?
C: Bu endpoint yalnızca ulusal resmi tatilleri döndürür. Eyalet, il veya bölgeye özgü kutlamalar (ör. ABD eyalet tatilleri, Alman eyaleti tatilleri) varsayılan yanıta dahil değildir. Alt bölge düzeyinde tatil verisine ihtiyacınız varsa bize ulaşın.
S: Yapay zeka ajanları bunu bir tool olarak kullanabilir mi?
C: Evet. Endpoint iki sorgu parametresi (country ve year) alır ve yapılandırılmış bir JSON dizisi döndürür — OpenAI, Claude, LangChain veya herhangi bir ajan framework için bir function tool olarak tanımlaması kolaydır. Birden fazla ülkede iş günleri üzerine akıl yürütmesi gereken planlama ajanları için idealdir.
Public Holidays'i Claude Code ve Yapay Zeka Ajanlarında Kullanın
100+ ülke için resmi tatilleri doğrudan yapay zeka kodlama ajanınız içinde sorgulamak için resmi Claude Code skill'ini yükleyin — doğal dille sıralanmış tarihler, resmi adlar ve sayılar.
Yapay zeka ajanınıza doğal biçimde sorun
Uyumlu platformlar
APIpick Public Holidays API'si için Claude Code skill'i
100+ ülke için tarihe göre sıralanmış tatil listelerini resmi İngilizce adlar ve toplam sayılarla döndürür. 1900'den 10 yıl sonrasına kadarki yılları destekler.