---
title: "영업일 API 7곳 비교·계산법 | Narwhal API"
description: "영업일 API가 따로 있을까요? 공휴일을 받아 평일에서 빼는 방법과 급여·휴가 계산용 7개 소스를 비교합니다. 파이썬 함수 포함."
url: "https://narwhalapi.com/ko/compare/working-days-apis"
---

# 영업일 API: 국가별 영업일 계산

급여 소프트웨어에는 국가와 지역별 공휴일, 공휴일이 주말과 겹칠 때의 명확한 답, 결과를 저장해도 되는 약관이 필요합니다. Calendarific, HolidayAPI, Abstract는 Narwhal의 91개국보다 훨씬 많은 국가를 다룹니다. Nager.Date는 무료로 써 볼 수 있지만 상업적 이용자에게 후원을 요청합니다.

## 결정

여러 나라에서 직원에게 급여를 지급하고 대체일, 영업일 엔드포인트, 결과 저장 권한을 연 단위 가격 하나로 원한다면 HolidayAPI를 고르세요. 월 $12로 시작하려면 Calendarific입니다. 쿼터 없이 프로세스 내 JavaScript를 쓰려면 date-holidays입니다. 대상 국가가 Narwhal의 91개국에 들고 환율, 경제 지표, MCP를 키 하나로 쓰고 싶다면 Narwhal을 고르세요.

## 공급자 후보 목록

모든 수치는 공급사 자체 페이지에서 가져왔으며 2026년 11월 3일에 확인했습니다. 공휴일에 누구에게 얼마를 지급하는지는 노동법과 계약으로 정해지며 어떤 API도 답해 주지 않습니다. 이 페이지는 Narwhal에서 게시합니다.

### Narwhal API

대상 91개국의 급여 계산에서 환율, 경제 지표, MCP도 같은 키로 쓰고 싶을 때.

[Narwhal 제품 탐색](https://narwhalapi.com/ko/api/calendars/holidays.md)

### Calendarific

매우 넓은 국가 목록에 지역별 세부 정보와 공휴일 유형을 갖춘 저렴한 월 단위 시작 플랜입니다.

[상세 비교 읽기](https://narwhalapi.com/ko/compare/calendarific.md)

### HolidayAPI

대체일, 영업일 계산, 결과를 보관할 권리가 필요한 다국가 급여 계산에 알맞습니다.

[상세 비교 읽기](https://narwhalapi.com/ko/compare/holidayapi.md)

### Nager.Date

키가 필요 없고 요청 한도도 명시되지 않은 무료 호스팅 API로 충분한 프로토타입과 내부 도구에 알맞습니다.

[상세 비교 읽기](https://narwhalapi.com/ko/compare/nager-date.md)

### Abstract API

이미 다른 Abstract API를 쓰고 있으며 지역별 항목이 있는 공휴일 엔드포인트 하나를 원하는 팀에 알맞습니다.

[상세 비교 읽기](https://narwhalapi.com/ko/compare/abstract-api.md)

### date-holidays

쿼터도 네트워크 호출도 없이 공휴일 규칙을 프로세스 안에 두고 싶은 Node.js 급여 엔진에 알맞습니다.

[상세 비교 읽기](https://narwhalapi.com/ko/compare/date-holidays.md)

### 연방준비제도의 Federal Reserve Financial Services

연방준비은행이 문을 닫는 날을 피해 미국 직접 입금 급여일을 옮기는 용도에 알맞습니다.

## 옵션 비교

가장 적합한 서비스를 고른다고 해서 모든 서비스의 기능이 같다는 뜻은 아닙니다. 근거와 제한 사항을 함께 확인하세요.

| 공급자 | 최적 대상 | 확인한 근거 | 중요 제한 사항 |
| --- | --- | --- | --- |
| Narwhal API | 대상 91개국의 급여 계산에서 환율, 경제 지표, MCP도 같은 키로 쓰고 싶을 때. | 정부 공식 출처를 사용합니다. 연도별, 날짜별, 다음 공휴일 조회를 지원하며 범위, 현지 이름, 하위 지역 코드가 포함됩니다. 모든 계정에 월 $10 무료 크레딧이 제공되고 상업용 앱 사용도 포함됩니다. | 대형 공급사에 비해 국가 수가 훨씬 적습니다. 확인한 응답에는 대체일 필드가 없으며 영업일은 직접 코드로 계산해야 합니다. |
| Calendarific | 매우 넓은 국가 목록에 지역별 세부 정보와 공휴일 유형을 갖춘 저렴한 월 단위 시작 플랜입니다. | 230개국 이상, 3,300개 이상의 지역을 지원하며 ISO 3166-2 위치 필터를 모든 플랜에서 쓸 수 있습니다. Starter는 월 $12 또는 연 $100에 10,000회 호출입니다. | 대체일 필드나 영업일 도우미는 문서에 없습니다. Free는 500회 호출이며 출처 표기가 필요하고, Free와 Starter의 데이터는 분기마다 갱신됩니다. |
| HolidayAPI | 대체일, 영업일 계산, 결과를 보관할 권리가 필요한 다국가 급여 계산에 알맞습니다. | 250개국, 대체일, /workday 및 /workdays 엔드포인트, 1년부터 2050년 이후까지의 연도를 지원합니다. Countries는 연 $249에 월 1,000,000 요청이며 상업적 이용과 오프라인 저장이 가능합니다. | 결제는 연 단위뿐입니다. 지역 공휴일은 연 $399의 States & Provinces 플랜이 필요하며 무료 플랜의 요청 한도는 공개되어 있지 않습니다. |
| Nager.Date | 키가 필요 없고 요청 한도도 명시되지 않은 무료 호스팅 API로 충분한 프로토타입과 내부 도구에 알맞습니다. | MIT 코드이며 사용 가능 국가 엔드포인트에 204개국이 있고, Bank를 포함한 6가지 공휴일 유형과 1단계 지역을 지원합니다. 저희 테스트에서는 2025년부터 2031년까지 반환됐습니다. | 약관은 상업적 이용 시 적극적인 후원을 요구하지만 금액은 명시하지 않습니다. 이드 날짜는 빠져 있고 일부 날짜는 대략적이거나 잠정적이라고 표시됩니다. |
| Abstract API | 이미 다른 Abstract API를 쓰고 있으며 지역별 항목이 있는 공휴일 엔드포인트 하나를 원하는 팀에 알맞습니다. | 190개국 이상, 3,500개 이상의 지역을 지원하며 연도는 서기 1년부터 2050년 이후까지입니다. Free는 1,000 요청에 초당 1회이고, Standard는 연 결제 기준 월 $99입니다. | 상업적 조건은 명시되지 않았습니다. 데이터 검증 주기가 한 곳에서는 매주, 다른 곳에서는 매월로 적혀 있고, 문서는 러시아를 RE, 바하마를 BH로 표기합니다. |
| date-holidays | 쿼터도 네트워크 호출도 없이 공휴일 규칙을 프로세스 안에 두고 싶은 Node.js 급여 엔진에 알맞습니다. | 207개국, ISO 3166-2 지역, 5가지 공휴일 유형, 대체일 플래그, isHoliday(date)를 제공합니다. 3.38.0 버전은 2026년 10월 24일에 게시됐습니다. | 업데이트는 직접 배포해야 합니다. 데이터는 ShareAlike 조건의 CC BY-SA 3.0이고 npm 메타데이터에는 다른 라이선스 문자열이 적혀 있으므로, 파생 데이터를 저장하기 전에 약관을 확인하세요. |
| 연방준비제도의 Federal Reserve Financial Services | 연방준비은행이 문을 닫는 날을 피해 미국 직접 입금 급여일을 옮기는 용도에 알맞습니다. | 2026년부터 2030년까지의 FedCash 일정과 처리 종료 및 재개 시간이 담긴 FedACH 표가 있습니다. 토요일이 공휴일이면 그 앞 금요일에는 연방준비은행이 문을 엽니다. | API가 아니라 웹 페이지이며 미국 달러 결제 시스템만 다룹니다. 날짜는 직접 만든 표에 옮겨 적어야 합니다. |

## 요구에 따라 선택

### 공휴일이 주말과 겹칠 때

대체일을 문서로 제공하는 출처는 두 곳뿐입니다. HolidayAPI는 공휴일이 주말과 겹치면 원래 날짜와 다른 observed 날짜를 반환합니다. date-holidays는 대신 쉬는 날에 substitute 플래그를 붙입니다. Nager.Date, Calendarific, Abstract는 이런 필드를 문서화하지 않았고 우리가 확인한 Narwhal 응답에도 없습니다. 직원에게 앞선 금요일에 지급할지 뒤의 월요일에 지급할지는 회사 정책이므로, 그 규칙은 공휴일 목록 옆의 표에 두세요.

### 지역 공휴일

Calendarific은 모든 플랜에서 us-ny나 de-by 같은 ISO 3166-2 코드를 받습니다. HolidayAPI에서 같은 기능을 쓰려면 연 $399의 States & Provinces 플랜이 필요합니다. Nager.Date는 1단계까지만 지원해서 DE-BW, DE-BY, DE-ST에 Epiphany를 보여 주지만 주보다 세밀한 단위는 없습니다. date-holidays는 ISO 3166-2를 따릅니다. Narwhal 항목에는 하위 지역 코드가 있지만, 지역에 의존하기 전에 각 국가의 coverage 필드를 확인하세요.

### 은행 휴일, 공휴일, 기념일

급여는 보통 공휴일에 지급하고 기념일은 무시하므로 type 필드가 중요합니다. Nager.Date에는 Bank, School, Optional을 포함해 6가지 유형이 있습니다. date-holidays는 5가지입니다. Calendarific은 4가지 카테고리이며 type 필터를 모든 플랜에서 쓸 수 있습니다. HolidayAPI는 public을 true 또는 false로 지정합니다. Abstract는 자유 텍스트를 씁니다. Narwhal은 각 항목에 federal government나 national public 같은 범위를 표시합니다.

### 몇 년 앞까지 조회되는가

휴가 발생과 근무 일정 계획에는 다음 해 달력을 일찍 받아야 합니다. HolidayAPI와 Abstract는 둘 다 2050년과 그 이후까지 지원합니다. 저희가 Nager.Date를 테스트했을 때 2025년부터 2031년까지 반환됐고 그 범위 밖에서는 오류가 났습니다. Calendarific은 과거와 미래 연도를 지원한다고만 하고 숫자는 밝히지 않습니다. date-holidays는 규칙으로 계산하므로 고정된 범위가 없습니다. Narwhal은 연도를 경로로 받으니, 국가마다 필요한 연도를 먼저 테스트하세요.

### 결과 저장

유료 HolidayAPI 플랜은 구독하는 동안 오프라인 저장을 허용하고, Free는 24시간으로 제한됩니다. Nager.Date의 약관은 자체 공휴일 포털 운영을 금지하고 상업적 이용자에게 후원을 요청합니다. Calendarific은 제한을 명시하지 않으며 Free에서는 출처 표기가 필요합니다. date-holidays 데이터는 CC BY-SA 3.0입니다. Abstract는 아무 언급이 없습니다. Narwhal은 모든 계정에 상업용 앱 사용을 포함합니다. 캐시하기 전에 저장에 관해 요금 및 약관 페이지를 읽어 보세요.

### 크레딧이나 쿼터가 소진되었을 때

Narwhal은 402 insufficient_credits를 반환하고, 초과 요금을 부과하지 않으며, 오류는 집계하지 않습니다. 무료 크레딧은 매월 1일에 다시 채워집니다. Calendarific은 오류를 포함한 모든 요청을 집계하고 429 rate_limit_exceeded로 응답합니다. Abstract Free는 크레딧이 소진되면 422를 반환합니다. HolidayAPI 유료 플랜은 매월 1일 00:00 UTC에 초기화됩니다. Narwhal의 모든 국가에 대해 국가별 1년치를 한 번 가져오면 37회 호출로 약 $0.07입니다.

### 1,000회 호출당 비용

플랜 가격을 포함된 호출 수로 나눈 뒤 1,000을 곱합니다. Narwhal Calendars는 호출당 과금으로 1,000회에 $2이므로 나눌 플랜이 없습니다. Calendarific Starter는 $12 / 10,000 = 월 결제 시 $1.20, 연 $100 플랜이면 약 $0.83입니다. HolidayAPI Countries는 $249 / 12개월 / 1,000,000으로 약 $0.02입니다. Abstract Standard는 표기된 대로 월 $99에 연간 60,000 요청이면 $1,188 / 60,000 = $19.80입니다. 이 단위는 확인이 필요합니다.

### 휴일 여부 확인 및 영업일 도우미

HolidayAPI에는 시작일로부터 N 영업일 뒤의 날짜를 반환하는 /workday와 두 날짜 사이의 영업일 수를 세는 /workdays가 있습니다. Nager.Date에는 다음 공휴일 호출과 오늘이 공휴일인지 확인하는 호출이 있습니다. date-holidays에는 isHoliday(date)가 있습니다. Calendarific과 Abstract에는 없습니다. Narwhal에는 날짜 조회와 다음 공휴일 호출이 있고 영업일은 직접 코드로 계산하며, 결제 how-to에 그 방법이 나와 있습니다. 또한 여기서 MCP를 확인한 곳은 Narwhal뿐이며, 키 하나로 80개 도구를 쓸 수 있습니다.

[공급자 비교](https://narwhalapi.com/ko/compare/stock-market-holiday-apis.md)

### 이슬람력 공휴일과 이동 공휴일

이드 날짜는 달 관측에 달려 있습니다. Nager.Date는 Eid al-Fitr와 Eid al-Adha를 프로젝트에서 제외하고, 히즈라력 기반 날짜는 대략적인 날짜로 표시하므로 하루나 이틀 달라질 수 있습니다. 해당 국가의 직원에게는 정부 발표를 따르는 출처를 쓰세요. Narwhal은 정부 공식 출처를 읽으며 MCP 도구에는 히즈라력 날짜 변환이 있습니다. 직원에게 날짜를 약속하기 전에 급여를 지급하는 국가마다 확인하세요.

### 급여일과 은행 휴무

공휴일 목록만으로는 은행이 언제 파일을 처리하는지 알 수 없습니다. 미국 직접 입금의 경우 연방준비제도가 처리 종료 및 재개 시간이 담긴 FedACH 표를 공개합니다. 토요일이 공휴일이면 연방준비은행은 앞선 금요일에 문을 열고, 일요일이 공휴일이면 다음 월요일에 닫습니다. 이 표를 공휴일 API 옆의 두 번째 입력으로 다루고, 급여일에서 거꾸로 계산하세요.

[공급자 비교](https://narwhalapi.com/ko/compare/stock-market-holiday-apis.md)

각 제공업체의 상세 비교 페이지에는 비교에 사용한 공식 문서, 근거가 뒷받침하는 범위, 검토 날짜가 나와 있습니다. 검토됨: 2026-11-03

## 출처 및 검토 날짜

- [Calendarific 근거 및 출처](https://narwhalapi.com/ko/compare/calendarific.md)
- [HolidayAPI 근거 및 출처](https://narwhalapi.com/ko/compare/holidayapi.md)
- [Nager.Date 근거 및 출처](https://narwhalapi.com/ko/compare/nager-date.md)
- [Abstract API 근거 및 출처](https://narwhalapi.com/ko/compare/abstract-api.md)
- [date-holidays 근거 및 출처](https://narwhalapi.com/ko/compare/date-holidays.md)
- [요금 Narwhal API 가격 (narwhalapi.com)](https://narwhalapi.com/pricing.md)
- [데이터 범위 Narwhal API 커버리지 (narwhalapi.com)](https://narwhalapi.com/coverage.md)
- [요금 Calendarific 요금제 가격 (calendarific.com)](https://calendarific.com/pricing)
- [Calendarific API 문서 (calendarific.com)](https://calendarific.com/api-documentation)
- [Calendarific 지원 국가 (calendarific.com)](https://calendarific.com/supported-countries)
- [요금 HolidayAPI 요금제 가격 (holidayapi.com)](https://holidayapi.com/pricing)
- [문서 HolidayAPI 문서 (holidayapi.com)](https://holidayapi.com/docs)
- [Nager.Date GitHub 저장소 (github.com)](https://github.com/nager/Nager.Date)
- [Nager.Date 이용 약관 (nagerholidays.com)](https://nagerholidays.com/legal/termsofservice)
- [Nager.Date 국가 지원 범위 (nagerholidays.com)](https://nagerholidays.com/country/coverage)
- [API Nager.Date API (nagerholidays.com)](https://nagerholidays.com/api)
- [API Abstract 공휴일 API (abstractapi.com)](https://www.abstractapi.com/api/holidays-api)
- [API Abstract 공휴일 API 문서 (docs.abstractapi.com)](https://docs.abstractapi.com/api/holidays)
- [date-holidays GitHub 저장소 (github.com)](https://github.com/commenthol/date-holidays)
- [npm의 date-holidays (registry.npmjs.org)](https://registry.npmjs.org/date-holidays)
- [Federal Reserve Financial Services 휴무일 일정 (frbservices.org)](https://www.frbservices.org/about/holiday-schedules)

## 비교

- [무료 공휴일 API: 7곳 비교(파이썬 포함)](https://narwhalapi.com/ko/compare/holiday-apis.md)
- [HolidayAPI 대안과 Calendarific 대안: 공휴일 API](https://narwhalapi.com/ko/compare/holidayapi-alternatives.md)
- [Calendarific vs HolidayAPI](https://narwhalapi.com/ko/compare/calendarific-vs-holidayapi.md)
- [환율 API 무료·유료: 8곳 비교](https://narwhalapi.com/ko/compare/fx-apis.md)
- [경제 데이터 API 비교](https://narwhalapi.com/ko/compare/economic-data-apis.md)
- [모든 비교](https://narwhalapi.com/ko/compare.md)

## 무료 키로 시작하세요

매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.

[무료 API 키 받기](https://narwhalapi.com/ko/signup)
