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

Public Holidays API

สอบถามวันหยุดราชการของกว่า 100 ประเทศและปีใดก็ได้ในการเรียก API ครั้งเดียว คำนวณในเครื่องทั้งหมด — ไม่มีแหล่งข้อมูลภายนอก ไม่มีเรื่องเซอร์ไพรส์เรื่อง rate limit

กว่า 100 ประเทศปีใดก็ได้ไม่ต้องพึ่งภายนอก
auth · x-api-key

ยังไม่มี API Key?

เข้าสู่ระบบบัญชีของคุณเพื่อสร้างและจัดการ API Key

เข้าสู่ระบบจัดการ API Key
[ 02 · integrate ]

คู่มือการผสานรวม

คัดลอกสนิปเพ็ต แทนที่ API key ของคุณ แล้วรัน ใช้ได้กับ HTTP client ทุกตัว — ตัวอย่างด้านล่างเป็น cURL, JavaScript และ Python

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

Get all public holidays for a country and year

พารามิเตอร์
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

ยกเว้นวันหยุดราชการโดยอัตโนมัติเมื่อคำนวณยอดวันลา รอบการจ่ายเงินเดือน และตารางกะงานในหลายประเทศ

📈

ปฏิทินการซื้อขาย

ข้ามวันที่ไม่มีการซื้อขายในแบบจำลองทางการเงินและ backtest ระบุวันหยุดธนาคารที่ส่งผลต่อหน้าต่างการชำระราคาและการเคลียริ่ง

📦

การประเมินเวลาส่งของโลจิสติกส์

คำนวณประมาณการส่งของที่แม่นยำโดยข้ามวันหยุดในประเทศต้นทาง ทางผ่าน และปลายทางโดยอัตโนมัติ

⚙️

การทำงานอัตโนมัติด้วย n8n

เชื่อมเข้ากับเวิร์กโฟลว์ n8n หรือ Zapier เพื่อควบคุมการกระทำที่ไวต่อเวลา — งดส่งอีเมลหรือรายงานในวันหยุดประจำชาติ

ทางเลือกแทน HolidayAPI และ Nager.Date

ข้อมูลปีปัจจุบัน การวางแผนสำหรับปีอนาคต และ SLA ระดับ production — โดยไม่มีการล็อกปีในแพ็กเกจฟรีหรือความเสี่ยงด้านความน่าเชื่อถือของโปรเจกต์ชุมชน

HolidayAPI
Nager.Date
API Pick ✓
แพ็กเกจฟรีปีก่อนหน้าเท่านั้นฟรี (ไม่มี SLA)100 เครดิตเมื่อสมัคร
ข้อมูลปีปัจจุบันแพ็กเกจแบบชำระเงินเท่านั้น✓✓
ข้อมูลปีอนาคตแพ็กเกจแบบชำระเงินเท่านั้น✓ (จำกัด)✓ ล่วงหน้าถึง +10 ปี
ข้อมูลย้อนหลัง (ตั้งแต่ปี 1900)แพ็กเกจแบบชำระเงินเท่านั้นบางส่วน✓ ตั้งแต่ปี 1900
SLA ระดับ productionแพ็กเกจแบบชำระเงินเท่านั้น✗ โปรเจกต์ชุมชน✓
ประเทศที่ครอบคลุม~100~110100+
ไม่ต้องใช้บัตรเครดิตเพื่อเริ่มต้น✗✓✓
เครดิต / คำขอหมดอายุ?แพ็กเกจรายปีN/Aไม่มีวันหมดอายุ
พร้อมใช้กับ AI agent / LLMบางส่วนบางส่วน✓ JSON ในตัว

กับดักแพ็กเกจฟรีของ HolidayAPI

แพ็กเกจฟรีของ HolidayAPI ถูกจำกัดโดยตั้งใจให้เป็น เฉพาะปีปฏิทินก่อนหน้าเท่านั้น ต้องการดูวันหยุดของปีปัจจุบันหรือวางแผนตารางวันลาปี 2027 ล่วงหน้า? คุณต้องอัปเกรดเป็นแพ็กเกจแบบชำระเงิน สำหรับกรณีการใช้งานด้านการจัดตารางหรือระบบอัตโนมัติใด ๆ สิ่งนี้ทำให้แพ็กเกจฟรีแทบไร้ประโยชน์ตั้งแต่วันแรก

ความเสี่ยงด้านความน่าเชื่อถือของ Nager.Date

Nager.Date เป็นโปรเจกต์โอเพนซอร์สที่ชุมชนดูแล — ใช้ฟรีแต่ ไม่มี SLA ด้านความพร้อมใช้งาน ไม่มีสัญญาสนับสนุน และไม่รับประกันความพร้อมใช้งานต่อเนื่อง ทีมที่สร้างระบบเงินเดือนหรือ pipeline โลจิสติกส์บนมันเคยเจอปัญหาจากการหยุดทำงานที่ไม่คาดคิดหรือการเลิกใช้งาน เหมาะกับการสร้างต้นแบบ ไม่ใช่สำหรับ production

ฟิลด์ Response

ฟิลด์ประเภทคำอธิบาย
data.countrystringรหัสประเทศ ISO 3166-1 alpha-2 (ตัวพิมพ์ใหญ่)
data.country_namestringชื่อประเทศเต็มภาษาอังกฤษ
data.yearintegerปีปฏิทินที่ค้นหา
data.totalintegerจำนวนวันหยุดราชการในปีนั้น
data.holidaysarrayรายการอ็อบเจกต์วันหยุดที่เรียงตามวันที่
data.holidays[].datestringวันที่วันหยุดในรูปแบบ YYYY-MM-DD
data.holidays[].namestringชื่อทางการของวันหยุด
credits_usedintegerเครดิตที่หักสำหรับคำขอนี้
remaining_creditsintegerเครดิตที่เหลือในบัญชีของคุณ
[ 03 · limits ]

Rate limit

การจำกัดอัตราเป็นแบบต่อ API key ในหน้าต่างเลื่อน 60 วินาที เมื่อถึงขีดจำกัดคุณจะได้ 429 ที่สะอาดพร้อม header Retry-After

อัตราการร้องขอ

120req/min

ต่อ API key ต่อ endpoint หน้าต่างเลื่อน 60 วินาที

การทำงานพร้อมกัน

3concurrent

จำนวนคำขอที่กำลังดำเนินการพร้อมกันได้สูงสุดต่อ API key

response headers
X-RateLimit-Limitจำนวนคำขอสูงสุดที่อนุญาตต่อนาที
X-RateLimit-Remainingจำนวนคำขอที่เหลือในหน้าต่างปัจจุบัน
X-RateLimit-Resetจำนวนวินาทีจนกว่าหน้าต่างปัจจุบันจะรีเซ็ต
Retry-Afterจำนวนวินาทีที่ต้องรอก่อนลองใหม่ (เฉพาะเมื่อได้ 429)
● 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
}

คำถามที่พบบ่อย

ถาม: รองรับประเทศใดบ้าง?

ตอบ: กว่า 100 ประเทศผ่านไลบรารีโอเพนซอร์ส python-holidays (vacanza) ซึ่งรวมถึงสหรัฐฯ สหราชอาณาจักร เยอรมนี ฝรั่งเศส ญี่ปุ่น จีน ออสเตรเลีย แคนาดา อินเดีย บราซิล และส่วนใหญ่ของยุโรป เอเชีย ละตินอเมริกา และแอฟริกา ใช้รหัส ISO 3166-1 alpha-2 ที่ถูกต้อง (เช่น US, GB, DE)

ถาม: ค้นหาย้อนหลังและล่วงหน้าได้ไกลแค่ไหน?

ตอบ: คุณสามารถค้นหาปีใดก็ได้ตั้งแต่ปี 1900 จนถึง 10 ปีในอนาคต วันหยุดในอดีตคำนวณจากกฎที่มีผลบังคับใช้ในขณะนั้น ผลลัพธ์จึงสะท้อนการถือปฏิบัติในอดีตจริง ไม่ใช่การนำกฎปัจจุบันไปฉายย้อนกลับ

ถาม: รวมวันหยุดระดับภูมิภาค/รัฐไหม?

ตอบ: endpoint นี้คืนเฉพาะวันหยุดราชการระดับชาติเท่านั้น การถือปฏิบัติเฉพาะรัฐ มณฑล หรือภูมิภาค (เช่น วันหยุดของรัฐในสหรัฐฯ วันหยุดของรัฐ Länder ในเยอรมนี) ไม่รวมอยู่ใน response เริ่มต้น ติดต่อเราหากคุณต้องการข้อมูลวันหยุดระดับเขตย่อย

ถาม: AI agent ใช้เป็น tool ได้ไหม?

ตอบ: ได้ endpoint รับพารามิเตอร์ query สองตัว (country และ year) และคืน array JSON ที่มีโครงสร้าง — กำหนดเป็น function tool สำหรับ OpenAI, Claude, LangChain หรือ agent framework ใดก็ได้อย่างตรงไปตรงมา เหมาะสำหรับ agent จัดตารางที่ต้องใช้เหตุผลเกี่ยวกับวันทำงานในหลายประเทศ

🤖Agent Skill

ใช้ Public Holidays ใน Claude Code และ AI Agent

ติดตั้งสกิล Claude Code ทางการเพื่อสอบถามวันหยุดราชการของกว่า 100 ประเทศได้โดยตรงภายใน AI coding agent ของคุณ — วันที่เรียงลำดับ ชื่อทางการ และจำนวนผ่านภาษาธรรมชาติ

ถาม AI agent ของคุณด้วยภาษาธรรมชาติ

›วันหยุดราชการของสหรัฐฯ ในปี 2026 มีอะไรบ้าง?
›แสดงวันหยุดราชการทั้งหมดในญี่ปุ่นสำหรับปีนี้
›26 ธันวาคมเป็นวันหยุดในสหราชอาณาจักรไหม?

แพลตฟอร์มที่รองรับ

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

สกิล Claude Code สำหรับ Public Holidays API ของ APIpick

คืนรายการวันหยุดที่เรียงตามวันที่พร้อมชื่อภาษาอังกฤษทางการและจำนวนรวมสำหรับกว่า 100 ประเทศ รองรับปีตั้งแต่ 1900 ถึง 10 ปีข้างหน้า

TypeScript•1 เครดิต / คำขอ•ติดตั้งฟรี
ดูสกิลบน GitHub