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"
}
]
}
MCPhttps://www.hudy.co.kr/api/mcp

설정 방법

Claude Desktop, Cursor 등 MCP를 지원하는 AI 도구에서 아래 설정을 추가하세요.

Claude Code

터미널에서 아래 명령어를 실행하세요.

claude mcp add --transport http -H "x-api-key: YOUR_API_KEY" hudy https://www.hudy.co.kr/api/mcp

JSON Configuration

또는 설정 파일에 직접 추가할 수 있습니다.

{
"mcpServers": {
"hudy": {
"url": "https://www.hudy.co.kr/api/mcp",
"headers": {
"x-api-key": "hd_live_xxxx"
}
}
}
}

사용 가능한 도구

get_holidays공휴일 조회 (연도별, 기간별)
count_business_days영업일 수 계산
add / subtract_business_days영업일 더하기 / 빼기
check_business_day영업일 여부 확인
custom_holidays CRUD커스텀 공휴일 생성, 조회, 수정, 삭제
GEThttps://api.hudy.co.kr/v2/business-days/check

Parameters

dayoptional
확인할 날짜 (YYYY-MM-DD). 미지정 시 오늘

Example Response

{
"result": true,
"data": {
"date": "2026-02-17",
"is_business_day": true,
"day_of_week": "화요일"
}
}
GEThttps://api.hudy.co.kr/v2/business-days/count

Parameters

fromrequired
시작 날짜 (YYYY-MM-DD)
torequired
종료 날짜 (YYYY-MM-DD)

Example Response

{
"result": true,
"data": {
"from": "2026-01-01",
"to": "2026-01-31",
"business_days": 21,
"total_days": 31,
"holidays_in_range": 1
}
}
GEThttps://api.hudy.co.kr/v2/business-days/add

Parameters

fromrequired
기준 날짜 (YYYY-MM-DD)
daysrequired
더할 영업일 수 (1-3650)

Example Response

{
"result": true,
"data": {
"from": "2026-02-15",
"days": 10,
"result_date": "2026-03-03"
}
}
GEThttps://api.hudy.co.kr/v2/business-days/subtract

Parameters

fromrequired
기준 날짜 (YYYY-MM-DD)
daysrequired
뺄 영업일 수 (1-3650)

Example Response

{
"result": true,
"data": {
"from": "2026-02-15",
"days": 5,
"result_date": "2026-02-06"
}
}

Installation

npm install @hudy-sdk/sdk

Quick Start

import { HudyClient } from '@hudy-sdk/sdk'
const client = new HudyClient({ apiKey: 'hd_live_xxxx' })
// 공휴일 조회
const holidays = await client.getHolidays(2026)
// 영업일 체크
const result = await client.isBusinessDay(new Date('2026-02-17'))
npm에서 자세히 보기 →

Installation

pip install hudy-sdk

Quick Start

from datetime import date
from hudy import HudyClient
client = HudyClient(api_key="hd_live_xxxx")
# 공휴일 조회
holidays = client.get_holidays(2026)
# 영업일 체크
result = client.is_business_day(date(2026, 2, 17))
PyPI에서 자세히 보기 →

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% 이상의 가동률을 유지합니다.