apipick
[ reference · holidays ]● 1 cr · 120 req/min

Public Holidays API

एक ही API कॉल में 100+ देशों और किसी भी वर्ष के सार्वजनिक अवकाश खोजें। पूरी तरह लोकल गणना — कोई बाहरी डेटा स्रोत नहीं, कोई rate-limit आश्चर्य नहीं।

100+ देशकोई भी वर्षकोई बाहरी निर्भरता नहीं
auth · x-api-key

API key नहीं है?

अपनी API keys बनाने और मैनेज करने के लिए अपने खाते में साइन इन करें।

साइन इन करेंAPI Keys मैनेज करें
[ 02 · integrate ]

इंटीग्रेशन गाइड

एक snippet कॉपी करें, अपनी API key बदलें, रन करें। किसी भी HTTP क्लाइंट में काम करता है — नीचे cURL, JavaScript और Python में उदाहरण।

spec
GET/api/holidays
base
https://www.apipick.com

Get all public holidays for a country and year

parameters
countrystringआवश्यक

ISO 3166-1 alpha-2 country code US

yearintegerवैकल्पिक

4-digit year (defaults to current year) 2026

curl -X GET "https://www.apipick.com/api/holidays" \
  -H "x-api-key: YOUR_API_KEY"
● 200 · response
{
  "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
}

वास्तविक शेड्यूलिंग के लिए बनाया गया

🏢

HR शेड्यूलिंग

कई देशों में छुट्टी बैलेंस, पेरोल चक्र और शिफ़्ट रोस्टर की गणना करते समय सार्वजनिक अवकाशों को अपने आप बाहर रखें।

📈

ट्रेडिंग कैलेंडर

वित्तीय मॉडल और बैकटेस्ट में गैर-ट्रेडिंग दिनों को छोड़ें। सेटलमेंट और क्लियरिंग विंडो को प्रभावित करने वाले बैंक अवकाशों की पहचान करें।

📦

लॉजिस्टिक्स ETAs

मूल, ट्रांज़िट और गंतव्य देशों में अवकाशों को अपने आप छोड़कर सटीक डिलीवरी अनुमान की गणना करें।

⚙️

n8n ऑटोमेशन

समय-संवेदनशील कार्यों को गेट करने के लिए n8n या Zapier वर्कफ़्लो में जोड़ें — राष्ट्रीय अवकाशों पर ईमेल या रिपोर्ट भेजना छोड़ें।

HolidayAPI और Nager.Date का विकल्प

वर्तमान-वर्ष डेटा, भविष्य-वर्ष योजना और एक प्रोडक्शन SLA — मुफ़्त-टियर वर्ष लॉक या community-project विश्वसनीयता जोखिम के बिना।

HolidayAPI
Nager.Date
API Pick ✓
मुफ़्त टियरकेवल पिछला वर्षमुफ़्त (कोई SLA नहीं)साइनअप पर 100 credits
वर्तमान वर्ष डेटाकेवल पेड प्लान✓✓
भविष्य वर्ष डेटाकेवल पेड प्लान✓ (सीमित)✓ +10 वर्षों तक
ऐतिहासिक डेटा (1900+)केवल पेड प्लानआंशिक✓ 1900 से
प्रोडक्शन SLAकेवल पेड प्लान✗ Community प्रोजेक्ट✓
कवर किए गए देश~100~110100+
शुरू करने के लिए कोई क्रेडिट कार्ड नहीं✗✓✓
credits / requests समाप्त होते हैं?वार्षिक प्लानN/Aकभी समाप्त नहीं
AI एजेंट / LLM रेडीआंशिकआंशिक✓ नेटिव JSON

HolidayAPI मुफ़्त-टियर जाल

HolidayAPI का मुफ़्त प्लान जानबूझकर सीमित है केवल पिछले कैलेंडर वर्ष तक। वर्तमान वर्ष के अवकाश देखने या 2027 की छुट्टी अनुसूची की पहले से योजना बनाने की आवश्यकता है? आपको एक पेड प्लान में अपग्रेड करना होगा। किसी भी शेड्यूलिंग या ऑटोमेशन उपयोग के मामले के लिए, यह मुफ़्त टियर को पहले दिन से ही व्यावहारिक रूप से बेकार बना देता है।

Nager.Date विश्वसनीयता जोखिम

Nager.Date एक community-अनुरक्षित ओपन-सोर्स प्रोजेक्ट है — इस्तेमाल करने के लिए मुफ़्त लेकिन कोई uptime SLA नहीं, कोई सपोर्ट कॉन्ट्रैक्ट नहीं और निरंतर उपलब्धता की कोई गारंटी नहीं। जिन टीमों ने इस पर पेरोल सिस्टम या लॉजिस्टिक्स pipelines बनाए हैं, वे अप्रत्याशित डाउनटाइम या deprecation से फंस गई हैं। प्रोटोटाइपिंग के लिए ठीक; प्रोडक्शन के लिए नहीं।

Response फ़ील्ड

फ़ील्डप्रकारविवरण
data.countrystringISO 3166-1 alpha-2 देश कोड (अपरकेस)
data.country_namestringदेश का पूरा अंग्रेज़ी नाम
data.yearintegerक्वेरी किया गया कैलेंडर वर्ष
data.totalintegerवर्ष में सार्वजनिक अवकाशों की संख्या
data.holidaysarrayतारीख के अनुसार क्रमबद्ध अवकाश ऑब्जेक्ट्स की सूची
data.holidays[].datestringYYYY-MM-DD फ़ॉर्मैट में अवकाश तारीख
data.holidays[].namestringअवकाश का आधिकारिक नाम
credits_usedintegerइस request के लिए काटे गए credits
remaining_creditsintegerआपके अकाउंट में शेष credits
[ 03 · limits ]

Rate limits

थ्रॉटलिंग प्रति API key है, 60-सेकंड की स्लाइडिंग विंडो। लिमिट पार करने पर आपको Retry-After हेडर के साथ साफ़ 429 मिलता है।

request rate

120req/min

प्रति API key, प्रति endpoint। 60-सेकंड की स्लाइडिंग विंडो।

concurrency

3concurrent

प्रति API key अधिकतम एक साथ चल रहे requests।

response headers
X-RateLimit-Limitप्रति मिनट अनुमत अधिकतम requests
X-RateLimit-Remainingमौजूदा विंडो में शेष requests
X-RateLimit-Resetमौजूदा विंडो रीसेट होने में सेकंड
Retry-Afterपुनः प्रयास से पहले प्रतीक्षा के सेकंड (केवल 429 पर)
● 429 · too many requests
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
}

अक्सर पूछे जाने वाले प्रश्न

प्र: कौन से देश समर्थित हैं?

उ: ओपन-सोर्स python-holidays (vacanza) लाइब्रेरी के ज़रिए 100+ देश। इसमें US, UK, जर्मनी, फ़्रांस, जापान, चीन, ऑस्ट्रेलिया, कनाडा, भारत, ब्राज़ील और अधिकांश यूरोप, एशिया, लैटिन अमेरिका और अफ़्रीका शामिल हैं। एक वैध ISO 3166-1 alpha-2 कोड का उपयोग करें (जैसे US, GB, DE)।

प्र: मैं कितना पीछे और आगे तक क्वेरी कर सकता हूं?

उ: आप 1900 से लेकर भविष्य में 10 वर्षों तक किसी भी वर्ष की क्वेरी कर सकते हैं। ऐतिहासिक अवकाशों की गणना उस समय प्रभावी नियमों के आधार पर की जाती है, इसलिए परिणाम आज के नियमों को पीछे प्रक्षेपित करने के बजाय वास्तविक ऐतिहासिक अनुपालन दर्शाते हैं।

प्र: क्या क्षेत्रीय/राज्य अवकाश शामिल हैं?

उ: यह endpoint केवल राष्ट्रीय सार्वजनिक अवकाश लौटाता है। राज्य-, प्रांत- या क्षेत्र-विशिष्ट अनुपालन (जैसे US राज्य अवकाश, जर्मन Länder अवकाश) डिफ़ॉल्ट response में शामिल नहीं हैं। यदि आपको उपविभाग-स्तरीय अवकाश डेटा चाहिए तो हमसे संपर्क करें।

प्र: क्या AI एजेंट इसे एक tool के रूप में उपयोग कर सकते हैं?

उ: हां। endpoint दो query parameters (country और year) लेता है और एक संरचित JSON array लौटाता है — इसे OpenAI, Claude, LangChain या किसी भी एजेंट फ़्रेमवर्क के लिए एक function tool के रूप में परिभाषित करना सीधा है। उन शेड्यूलिंग एजेंट्स के लिए आदर्श जिन्हें कई देशों में कार्य दिवसों के बारे में तर्क करने की आवश्यकता होती है।

🤖Agent Skill

Claude Code और AI एजेंट्स में Public Holidays का उपयोग करें

अपने AI कोडिंग एजेंट के भीतर सीधे 100+ देशों के सार्वजनिक अवकाश खोजने के लिए आधिकारिक Claude Code skill इंस्टॉल करें — प्राकृतिक भाषा के ज़रिए क्रमबद्ध तारीखें, आधिकारिक नाम और गिनती।

अपने AI एजेंट से स्वाभाविक रूप से पूछें

›2026 में US के सार्वजनिक अवकाश क्या हैं?
›इस वर्ष जापान के सभी सार्वजनिक अवकाश सूचीबद्ध करें
›क्या 26 दिसंबर UK में एक अवकाश है?

संगत प्लेटफ़ॉर्म

Claude CodeCursorOpenAI CodexManusGoogle AntigravityOpenClaw
apipick-lab /
apipick-public-holidays

APIpick Public Holidays API के लिए Claude Code skill

100+ देशों के लिए आधिकारिक अंग्रेज़ी नामों और कुल गिनती के साथ तारीख के अनुसार क्रमबद्ध अवकाश सूचियां लौटाता है। 1900 से लेकर 10 वर्ष आगे तक के वर्षों का समर्थन करता है।

TypeScript•1 credit / request•इंस्टॉल करने के लिए मुफ़्त
GitHub पर Skill देखें