[프로젝트] 국내 도서 검색 API 선택 과정

PROJECT

국내 도서 검색 API 선택 과정

목차

• 1. 왜 도서 API를 비교하게 됐나?
• 2. 국내에서 사용 가능한 도서 API
• 3. API별 비교
• 4. 알라딘 Open API
• 5. 카카오 책 검색 API
• 6. 네이버 책 검색 API
• 7. 국립중앙도서관 Open API
• 8. 도서관 정보나루 API
• 9. 최종 선택: 알라딘 API
• 10. 마무리

독서 습관 관리 서비스를 개발하고 있는데 “도서 데이터를 어디서 가져올 것인가?” 에 대한 고민이 생겼다.

1. 왜 도서 API를 비교하게 됐나?

처음에는 단순히 제목만 검색되면 될 줄 알았다. 그런데 막상 구현하려고 보니 생각보다 고려해야 할 요소가 많았다.

• 표지 이미지 제공 여부
• 신간 / 베스트셀러 데이터 제공 여부
• 가격 정보 제공 여부
• JSON 지원 여부
• API 관리 상태
• 키 발급 속도

특히 독서 서비스에서는 단순 텍스트보다 책 표지 이미지의 중요도가 굉장히 크다. UI 완성도 자체가 달라지기 때문이다. 이번 글에서는 국내에서 사용할 수 있는 대표적인 도서 검색 API들을 비교하고, 최종적으로 왜 알라딘 API를 선택했는지 정리해보려고 한다.

2. 국내에서 사용 가능한 도서 API

국내에서 사용할 수 있는 대표적인 도서 관련 API는 아래 정도가 있다.

API	특징
알라딘 Open API	도서 서비스 개발에서 가장 많이 사용되는 편
카카오 책 검색 API	카카오 검색 기반
네이버 책 검색 API	네이버 검색 결과 기반
국립중앙도서관 Open API	공공 데이터 중심
도서관 정보나루 API	도서관 대출/인기 데이터 제공
교보문고 / 영풍문고	공식 Open API 미제공

 

선택지가 많았는데 이 중에 무슨 API를 선택할지 고민이었다. 특히 의외였던 부분은 국내 대형 서점인 교보문고, 영풍문고가 공식 Open API를 제공하지 않는다는 점이었다. 그래서 실제 서비스에서는 결국 알라딘 API를 사용하는 경우가 꽤 많았다.

3. API별 비교

개발하면서 중요하게 봤던 기준들을 중심으로 정리해봤다.

API	표지 이미지	신간/베스트셀러	가격 정보	응답 형식	키 발급	관리 상태
알라딘 Open API	O	O	O	JSON / XML	비교적 빠름	활발
카카오 책 검색 API	O	X	일부	JSON	매우 빠름	활발
네이버 책 검색 API	O	X	일부	JSON / XML	빠름	보통
국립중앙도서관 API	부족	X	X	XML 중심	느린 편	다소 보수적
도서관 정보나루 API	제한적	대출 기반 인기 정보	X	JSON / XML	보통	운영 중

4. 알라딘 Open API

개인적으로는 가장 서비스 개발 친화적이었다. 특히 좋았던 부분은 아래였다.

• 표지 이미지 품질이 괜찮음
• 신간 / 베스트셀러 API 제공
• 가격 정보 제공
• JSON 응답 지원
• 실제 도서 서비스에서 많이 사용됨

독서 앱에서는 단순 검색보다도 홈 화면 구성 요소가 중요하다.

 

예를 들면

• 오늘의 추천 도서
• 신간 목록
• 베스트셀러
• 카테고리별 도서

이런 데이터가 필요해지는데, 알라딘 API는 이런 부분이 꽤 잘 되어 있었다. 무엇보다 좋았던 건 JSON 응답이었다. Spring Boot에서 DTO 매핑할 때도 편했고, Android나 React 쪽에서도 다루기 수월했다.

실제로 구현하면서 느낀 건 “도서 검색만 필요한 API가 아니라, 도서 서비스 자체를 만들기 좋은 API” 에 가까웠다.

5. 카카오 책 검색 API

카카오 API는 사용성 자체는 굉장히 좋았다. 키 발급도 빠르고, 문서도 비교적 깔끔한 편이다. 검색 품질도 나쁘지 않았다. 다만 아쉬웠던 점은

• 신간 API 없음
• 베스트셀러 API 없음
• 도서 서비스 특화 기능 부족

즉, “검색 API”에 더 가까운 느낌이었다. 책 검색 기능만 필요한 경우에는 충분히 좋은 선택이라고 생각한다.

6. 네이버 책 검색 API

네이버도 기본적인 검색 기능은 제공한다. 예전부터 존재하던 API라 자료도 꽤 많다. 다만 실제로 비교해보면

• 응답 데이터 구조가 다소 오래된 느낌
• 도서 메타데이터 품질 편차 존재
• 서비스 확장성은 애매

라는 인상이 있었다. 그리고 최근에는 개발자들이 예전만큼 적극적으로 사용하는 분위기는 아니었다.

7. 국립중앙도서관 Open API

처음에는 공공 API라서 가장 신뢰도가 높을 줄 알았다. 그런데 실제 서비스 관점에서는 아쉬운 부분이 꽤 있었다. 대표적으로

• 표지 이미지가 부족함
• 신간 / 베스트셀러 제공 안 함
• XML 응답 중심
• UI 친화적인 데이터가 적음

특히 XML 응답은 생각보다 개발 피로도가 컸다. 물론 Spring에서는 XML 파싱도 가능하지만, 실제 프론트엔드까지 고려하면 JSON 기반 API가 훨씬 편했다. 그리고 독서 서비스에서는 결국 “보여지는 경험”이 중요한데, 표지 이미지가 부실한 점이 꽤 크게 느껴졌다.

8. 도서관 정보나루 API

이 API는 조금 성격이 다르다. 일반적인 도서 검색보다는

• 대출 순위
• 인기 도서
• 연령별 추천
• 지역별 대출 데이터

같은 공공 도서관 통계 데이터에 가까웠다.

 

그래서 일반적인 독서 앱보다는

• 독서 분석 서비스
• 추천 시스템
• 통계 기반 기능

쪽에서 더 활용도가 높아 보였다.

9. 최종 선택: 알라딘 API

최종적으로는 알라딘 API를 선택했다. 이유는 단순했다. 독서 서비스에서 필요한 요소들을 가장 균형 있게 제공했기 때문이다.

 

특히 아래 요소들이 결정적이었다.

• 표지 이미지 제공
• 신간 / 베스트셀러 제공
• 가격 정보 제공
• JSON 응답 지원
• 실제 서비스 UI 구성에 적합

도서 서비스는 결국 “검색”보다 “탐색 경험”이 더 중요하다고 생각한다.

 

사용자가

• 책을 발견하고
• 표지를 보고
• 관심을 느끼고
• 저장하고 기록하는 흐름

이 자연스럽게 이어져야 한다. 그 관점에서 알라딘 API가 가장 실용적인 선택이었다.

10. 마무리

처음에는 단순히 “책 검색 API 하나 붙이면 끝”이라고 생각했는데, 실제로는 서비스 방향에 따라 선택 기준이 꽤 달랐다.

 

만약

• 단순 검색 기능만 필요하다면 → 카카오
• 공공 데이터/통계 활용이 목적이라면 → 정보나루
• 실제 독서 서비스 개발이라면 → 알라딘

쪽이 더 적합하다고 느꼈다. 도서 API는 생각보다 선택지가 제한적인 분야라, 처음 설계 단계에서 충분히 비교해보고 결정하는 걸 추천한다.