v2.0 Released - Custom Holidays Support

Korean Public Holidays
API Service

대한민국 공휴일을 손쉽게 조회하고, 나만의 커스텀 공휴일을 등록하세요. 단 한 줄의 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": [
{ "date": "2026-01-01", "name": "신정" },
{ "date": "2026-02-16", "name": "설날" }
]
}

99.99%

Uptime SLA

< 50ms

Avg Response

12M+

API Calls / Month

3,200+

Active Developers

Features

개발자를 위해 설계된 API

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

공휴일 조회

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

커스텀 공휴일

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

빠른 응답 속도

글로벌 CDN으로 어디서나 50ms 이내 응답. 대규모 트래픽에도 안정적으로 서비스합니다.

개발자 친화적

RESTful API, JSON 응답, SDK 제공. 어떤 언어에서든 쉽게 연동할 수 있습니다.

Pricing

심플한 단일 요금제

복잡한 요금 체계는 없습니다. 모든 기능을 월 $3에 이용하세요.

All-in-One

HuDy Pro

$3/ month

모든 기능, 하나의 요금제. 지금 바로 시작하세요.

  • 무제한 API 호출
  • 커스텀 공휴일 등록
  • x-api-key 기반 인증
  • 대한민국 법정공휴일 전체 제공
  • 연도별 / 기간별 조회
  • 우선 기술 지원
  • API 사용량 대시보드
  • 99.9% Uptime SLA
지금 시작하기

API Reference

간단하고 직관적인 API

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

GETapi.hudy.co.kr/v2/holidays

Authentication

x-api-keyHeader로 API Key를 전달합니다.

Parameters

yearoptional
조회할 연도 (e.g. 2026)
fromoptional
조회 시작일 (e.g. 2026-01-01)
tooptional
조회 종료일 (e.g. 2026-12-31)

Example Response

{
"result": true,
"data": [
{ "date": "2026-01-01", "name": "신정" },
{ "date": "2026-02-16", "name": "설날" }
]
}