홈 | 성경읽기 | 통합검색 | 용어빈도 | 개발의견 | ✍ 성경필사

HolyBible REST API

18개 번역본 · 다국어 성경 검색 · 인터리니어 · 관주 · 성경사전
외부 서비스 연동을 위한 상업용 API

API 플랜
Trial
100
건 / 일
  • 성경 텍스트 조회
  • 기본 검색 (limit≤5)
  • Strong's / 관주
  • 병렬 검색
  • 전체 번역 비교
신청 후 발급
Starter
3,000
건 / 일
  • 성경 텍스트 조회
  • 검색 (limit≤20)
  • Strong's / 관주 / 사전
  • 병렬 검색
  • 전체 번역 비교
유료
Pro
30,000
건 / 일
  • 성경 텍스트 조회
  • 검색 (limit≤100)
  • Strong's / 관주 / 사전
  • 병렬 검색 ✓
  • 전체 번역 비교 ✓
유료
Enterprise
무제한
협의
  • 모든 기능 포함
  • 전용 Rate Limit
  • SLA 보장
  • 기술 지원
  • 커스텀 약관
문의

🔑 API Key 신청

API Key는 신청 검토 후 이메일로 발급됩니다. 저작권 관계로 한국어 번역본(개역개정 등)은 비상업적 용도로만 사용 가능합니다.

API Key 신청 이메일 보내기
인증

모든 외부 API 요청에 X-API-Key 헤더를 포함해야 합니다.

헤더값필수
X-API-Key발급받은 API Key (예: hb_pro___abc123...)✅ 필수
Content-Typeapplication/jsonPOST 시 필요
# curl 예시 curl -H "X-API-Key: hb_pro___your_key_here" \ "https://www.biblenote.kr/api/v2/verse/text?book=NEW04&chapter=3&verse=16&translation=H1_GAE"

응답 헤더:

헤더설명
X-RateLimit-Limit플랜 일일 한도
X-RateLimit-Remaining오늘 남은 호출 횟수
X-API-Plan현재 플랜 (trial/starter/pro/enterprise)
API 엔드포인트

📖 성경 텍스트

GET /api/v2/verse/text 단일 절 텍스트 조회 모든 플랜
파라미터타입설명
book 필수string책 코드 (예: NEW04, OLD01)
chapter 필수int장 번호
verse 필수int절 번호
translation 필수string번역본 코드 (예: H1_GAE, E1_KJV)
curl -H "X-API-Key: YOUR_KEY" \ "https://www.biblenote.kr/api/v2/verse/text?book=NEW04&chapter=3&verse=16&translation=H1_GAE"
응답 예시
{"success":true,"verse":{"book":"NEW4","book_name":"요한복음","chapter":3,"verse":16, "content":"하나님이 세상을 이처럼 사랑하사...","translation":"H1_GAE"}}
GET /api/v2/chapter 장 전체 읽기 모든 플랜
파라미터타입설명
book 필수string책 코드
chapter 필수int장 번호
translation 필수string번역본 코드
curl -H "X-API-Key: YOUR_KEY" \ "https://www.biblenote.kr/api/v2/chapter?book=NEW04&chapter=3&translation=E1_KJV"

🔍 검색

GET /api/v2/search 성경 + 사전 통합 검색 모든 플랜
파라미터타입설명
q 필수string검색어 (최대 200자)
translation 필수string번역본 코드
limit 선택int결과 수 (플랜별 상한 적용)
curl -H "X-API-Key: YOUR_KEY" \ "https://www.biblenote.kr/api/v2/search?q=love&translation=E1_KJV&limit=20"
GET /api/v2/parallel/search 모든 번역본 동시 검색 Pro 이상

⚠️ 서버 부하가 높은 엔드포인트입니다. Pro 플랜 이상에서만 사용 가능합니다.

파라미터타입설명
q 필수string검색어
limit 선택int번역본당 결과 수 (최대 100)
GET /api/v2/verse/compare 전 번역본 구절 비교 Pro 이상

⚠️ 서버 부하가 높은 엔드포인트입니다. Pro 플랜 이상에서만 사용 가능합니다.

파라미터타입설명
book 필수string책 코드
chapter 필수int장
verse 필수int절

🔤 원어 & 관주

GET /api/v2/strongs/verse 절별 헬라어/히브리어 원문 단어 모든 플랜
파라미터타입설명
book 필수string책 코드 (NEW01~NEW27, OLD01~OLD39)
chapter 필수int장
verse 필수int절
curl -H "X-API-Key: YOUR_KEY" \ "https://www.biblenote.kr/api/v2/strongs/verse?book=NEW04&chapter=1&verse=1"
응답 예시
{"words":[{"w":"Ἐν","s":"G1722","e":"In the","g":"PREP","l":"ἐν"},...]}
GET /api/v2/cross-refs 관주 (교차 참조) 조회 모든 플랜
파라미터타입설명
book 필수string책 코드
chapter 필수int장
verse 필수int절
limit 선택int최대 결과 수 (기본 10, 최대 50)
curl -H "X-API-Key: YOUR_KEY" \ "https://www.biblenote.kr/api/v2/cross-refs?book=NEW04&chapter=3&verse=16&limit=10"
GET /api/v2/dictionary/search 성경 사전 검색 (KCM + MLB) 모든 플랜
파라미터타입설명
term 필수string검색할 성경 용어 (한국어)
curl -H "X-API-Key: YOUR_KEY" \ "https://www.biblenote.kr/api/v2/dictionary/search?term=예수"
번역본 코드

⚠️ 저작권 안내

한국어 번역본(개역개정, 개역한글, 새번역 등)은 대한성서공회 저작권이 있으며 비상업적 이용에만 허용됩니다.
영어 KJV, 프랑스어 LSG는 Public Domain입니다.
인터리니어 데이터(Strong's)는 STEPBible CC BY, 관주는 OpenBible.info CC BY 라이선스입니다.

🇰🇷 한국어
H1_GAE개역개정
H0_RHV개역한글
H2_SAE공동번역
H2_SAENEW공동번역개정
H3_COGNEW현대어성경
H6_HKJV흠정역
H7_HDB현대인의성경
🇺🇸 영어
E1_KJVKJV (Public Domain)
E0_NIVNIV
E2_NASBNASB
🇫🇷 프랑스어
F0_LSGLSG 1910 (Public Domain)
🇯🇵 일본어
J0_KSNKI口語訳
J1_KKUG新改訳
J2_KSNKD新共同訳
🇨🇳 중국어
C0_GB简体中文
C1_B5繁體中文
기타
R0_RUSSIAРусский
A0_AZERAzərbaycan
책 코드 (일부)
코드책
OLD01창세기 (Genesis)
OLD02출애굽기 (Exodus)
OLD19시편 (Psalms)
OLD20잠언 (Proverbs)
OLD23이사야 (Isaiah)
OLD24예레미야 (Jeremiah)
코드책
NEW01마태복음 (Matthew)
NEW02마가복음 (Mark)
NEW03누가복음 (Luke)
NEW04요한복음 (John)
NEW05사도행전 (Acts)
NEW27요한계시록 (Revelation)

구약 OLD01~OLD39 (39권), 신약 NEW01~NEW27 (27권)

에러 코드
400
Bad Request — 필수 파라미터 누락 또는 잘못된 형식
401
Unauthorized — API Key가 없거나 잘못됨
403
Forbidden — 해당 플랜에서 허용되지 않는 엔드포인트, 또는 일일 한도 초과
429
Too Many Requests — 분당 호출 한도 초과 (Retry-After 헤더 확인)
# 에러 응답 형식 {"success": false, "error": "에러 메시지"}
이용 약관

1. API Key는 발급받은 서비스에 한해 사용 가능하며 제3자에게 양도할 수 없습니다.

2. 한국어 성경 번역본은 대한성서공회 저작권 정책에 따라 비상업적 용도로만 제공됩니다. 상업적 사용 시 별도 라이선스 계약이 필요합니다.

3. 서버 부하를 의도적으로 유발하는 행위(크롤링, 스크래핑, DoS)는 즉시 Key를 차단합니다.

4. 플랜 한도를 초과하면 해당 일은 서비스가 중단되며, 다음 날 자정에 자동 초기화됩니다.

5. API 응답에 포함된 성경 본문의 저작권은 각 번역본 저작권자에게 있습니다.