NEW - Official SDK & Business Day Check

대한민국 공휴일
API 서비스

대한민국 공휴일을 손쉽게 조회하고, 나만의 커스텀 공휴일을 등록하세요. 단 한 줄의 API 호출로 시작할 수 있습니다.

지금 시작하기API 문서 보기
GET /v2/holidays
curl https://api.hudy.co.kr/v2/holidays?year=2026 -H "x-api-key: YOUR_API_KEY"
{
"result": true,
"data": [
{
"id": "1",
"name": "신정",
"date": "2026-01-01",
"type": "public"
}
]
}

99.9%

Uptime SLA

< 100ms

Avg Response

REST

JSON API

Global Service

어디서든 빠르게 연결

안정적인 글로벌 인프라로 어디서든 빠른 응답을 보장합니다.

Features

개발자를 위해 설계된 API

단순한 공휴일 조회를 넘어, 비즈니스에 필요한 모든 휴일 관련 기능을 제공합니다.

공휴일 조회

대한민국 법정 공휴일, 대체 공휴일, 임시 공휴일까지 모두 정확하게 조회할 수 있습니다.

커스텀 공휴일

회사 창립기념일, 사내 행사일 등 나만의 커스텀 공휴일을 등록하고 API로 조회하세요.

영업일 관리
Pro

특정 날짜의 영업일 여부 확인, 기간 내 영업일 수 계산, N영업일 후/전 날짜 계산을 지원합니다.

공식 SDK

Node.js와 Python SDK를 제공합니다. npm install 또는 pip install 한 줄이면 바로 시작.

빠른 응답 속도

어디서나 100ms 이내 응답. 안정적인 인프라로 서비스합니다.

개발자 친화적

RESTful API, JSON 응답, MCP 지원. 어떤 언어에서든, AI Agent에서도 쉽게 연동할 수 있습니다.

Pricing

요금제

무료로 시작하고, 필요할 때 업그레이드하세요.

Free

무료

기본 공휴일 API를 무료로 이용하세요.

  • 월 100회 API 호출
  • x-api-key 기반 인증
  • 대한민국 법정공휴일 전체 제공
  • 연도별 / 기간별 조회
  • API 사용량 대시보드
  • 99.9% Uptime SLA
무료로 시작하기
Popular

HuDy Pro

$3/ month

30일 무료 체험

모든 기능, 한달 커피 한 잔 값으로 부담 없이 시작하세요.

무료 플랜의 모든 기능 +

  • 월 5,000회 API 호출
  • 커스텀 공휴일 등록
  • 영업일 계산 API
  • 캘린더 자동 동기화 (iCal)
  • 우선 기술 지원
30일 무료로 시작하기

무료 체험 후 월 $3 · 언제든 취소 가능

API Reference

간단하고 직관적인 API

RESTful API로 설계되어 어떤 언어에서든 쉽게 연동할 수 있습니다.

Authentication

x-api-keyAPI 키를 전달합니다. (예: x-api-key: hd_live_xxxx)
GEThttps://api.hudy.co.kr/v2/holidays

Parameters

yearoptional
조회할 연도 (e.g. 2026)

Example Response

{
"result": true,
"data": [
{
"id": "1",
"name": "신정",
"date": "2026-01-01",
"year": 2026,
"month": 1,
"day": 1,
"day_of_week": "수요일",
"type": "public"
}
]
}

FAQ

자주 묻는 질문

HuDy API에 대해 궁금한 점을 확인하세요.

네, 무료 플랜으로 월 100회까지 공휴일 조회 API를 사용할 수 있습니다. 영업일 계산, 커스텀 공휴일 등 추가 기능이 필요하시면 월 $3의 Pro 플랜을 이용해 주세요. 30일 무료 체험도 제공합니다.

공공데이터포털의 한국천문연구원 특일 정보(천문법에 근거한 공식 데이터)를 활용하여 대한민국 법정 공휴일, 대체 공휴일, 임시 공휴일을 모두 정확하게 제공합니다. 또한 회사 창립기념일 등 커스텀 공휴일을 직접 등록하여 API로 조회할 수 있습니다.

HuDy API의 영업일 계산 엔드포인트를 사용하면 특정 날짜의 영업일 여부 확인, 두 날짜 사이의 영업일 수 계산, N영업일 후/전 날짜 계산을 할 수 있습니다. 주말과 공휴일을 자동으로 제외합니다.

현재 Node.js/TypeScript(@hudy-sdk/sdk)와 Python(hudy-sdk)을 공식 지원합니다. npm install 또는 pip install 한 줄로 바로 사용할 수 있습니다.

MCP(Model Context Protocol) 서버를 통해 Claude Desktop, Cursor 등 AI 도구에서 공휴일 조회와 영업일 계산 기능을 바로 사용할 수 있습니다. 설정 파일에 HuDy MCP 서버 URL만 추가하면 됩니다.

HuDy API는 전 세계 어디서나 100ms 이내의 응답 속도를 보장합니다. 안정적인 인프라 위에서 서비스되며, 99.9% 이상의 가동률을 유지합니다.