Python :: 네이버 Book API로 책 데이터 가져오기
프로젝트 파우스트를 만들면서 네이버 북 API를 사용했는데, 꽤 괜찮았던 관계로 여기에 한번 정리해보려고 합니다.
네이버 책 API 로그인 및 등록
늘 그렇듯이, API를 이용하려면 먼저 키를 발급받아야 합니다.
-
네이버 개발자 사이트에 가서 로그인 후, 하단의 [Application] - [애플리케이션 등록]을 들어갑니다.
- 입력 란에 알맞게 입력해줍시다. 사용 API는 [검색], 비로그인 오픈 API 환경은 [WEB]으로 합니다. 주소란에 입력할 게 없다면 아무 주소나 입력해줍시다. (http://localhost 등)
- 등록을 마치셨다면, [내 애플리케이션]에서 방금 생성한 애플리케이션의 Client ID와 Client Secret을 볼 수 있습니다. 기억해둡시다.
기본 코드 작성
이제 코드를 작성해봅시다. 일단 가장 기본적인 구조는 다음과 같습니다. 아까 기억해두었던 KEY와 SECRET을 코드 상단에 입력합니다.
# Code written by Shiina Chianti #
CLIENT_ID = '애플리케이션 KEY'
CLIENT_SECRET = '애플리케이션 SECRET'
def search_book(query):
from urllib.request import Request, urlopen
from urllib.parse import urlencode, quote
import json
request = Request('https://openapi.naver.com/v1/search/book?query='+quote(query))
request.add_header('X-Naver-Client-Id', CLIENT_ID)
request.add_header('X-Naver-Client-Secret', CLIENT_SECRET)
response = urlopen(request).read().decode('utf-8')
search_result = json.loads(response)
return search_result
if __name__ == "__main__":
print(search_book('라플라스의 마녀'))
# output # (너무 길어서 중략했습니다.)
{'lastBuildDate': 'Mon, 20 Nov 2017 14:18:06 +0900', 'total': 8, 'start': 1, 'display': 8, 'items': [{'title': '<b>라플라스의 마녀</b> (히가시노 게이고 장편소설)', 'link': 'http://book.naver.com/bookdb/book_detail.php?bid=10007513', 'image': 'http://bookthumb.phinf.naver.net/cover/100/075/10007513.jpg?type=m1&udate=20170105', 'author': '히가시노 게이고', 'price': '14800', 'discount': '13320', 'publisher': '현대문학', 'pubdate': '20160111', 'isbn': '8972757578 9788972757573', 'description': '인류의 미지의 영역에 도전한 히가시노 게이고의 80번째 작품!히가시노 게이고 작가 데뷔 30주년 기념작 『<b>라플라스의 마녀</b>』. 그동안 치밀한 트릭과 반전이 빛나는 본 <..중략..> 경이 무엇인지, 그 말이 유행하게 된 시대 상황 및 사회적 배경은 무엇인지, 원뜻은 무엇이며 그 말은 어떤 계기로 변화하여 또 다른 비유적 표현을 낳았는지... '}]}
response 에는 ‘lastBuildDate’, ‘total’, ‘start’, ‘display’, ‘items’의 키가 담겨있습니다. 이중에서 items의 값에 검색된 책들의 데이터가 있습니다. 따라서 하단의 코드를 조금 수정하겠습니다.
if __name__ == "__main__":
books = search_book('라플라스의 마녀')['items']
for book in books:
print('title: {}'.format(book['title']))
print('author: {}'.format(book['author']))
print('pubdate: {}'.format(book['pubdate']))
print('-------------------------')
# output #
title: <b>라플라스의 마녀</b> (히가시노 게이고 장편소설)
author: 히가시노 게이고
pubdate: 20160111
-------------------------
title: ラプラスの魔女 (<b>라플라스의 마녀</b>)
author: 히가시노 게이고
pubdate: 20150515
-------------------------
title: 히가시노 게이고 장편소설 (전3권, 나미야 잡화점의 기적 외)
author: 히가시노 게이고
pubdate: 20170630
-------------------------
(..후략..)
각 item에는 [‘title’, ‘link’, ‘image’, ‘author’, ‘price’, ‘discount’, ‘publisher’, ‘pubdate’, ‘isbn’, ‘description’] 의 키가 존재합니다. 각각의 키에 대한 설명은 API 문서에 자세히 나와있습니다.
세부 검색 :: ISBN만으로 검색하기
상기의 경우처럼 Query로 검색을 했을 경우에는 원치 않은 책들이 많이 나올 수 있습니다. 만약 정확하게 한 권에 대한 정보만을 뽑아내고 싶으시다면 ISBN을 사용하는 것도 하나의 방법입니다.
여기서 ISBN이란 International Standard Book Number의 약자로서, 각각의 책마다 붙어 있는 고유한 책 번호 입니다. 보통 책의 첫장 혹은 마지막 장에 기재되어 있으며, 13자리의 숫자로 이루어져 있습니다. 책 정보 조회 사이트 등에서도 특정 책의 ISBN을 볼 수 있습니다.
Query에 ISBN을 입력해도 검색이 되긴 하지만, 네이버 API에서는 d_isbn을 사용해서 ISBN 전용 검색을 할 수 있습니다.
그러기 위해선 상기의 search_book() 함수의 request부분을 살짝 변경해주어야 합니다. 다음과 같이 말이죠.
request = Request('https://openapi.naver.com/v1/search/book_adv?d_isbn='+quote(query))
이하는 request 변경 후 ISBN으로 검색하는 코드와 결과입니다.
if __name__ == "__main__":
books = search_book('9788972757573')['items']
for book in books:
print(book)
# output #
{'title': '라플라스의 마녀 (히가시노 게이고 장편소설)', 'link': 'http://book.naver.com/bookdb/book_detail.php?bid=10007513', 'image': 'http://bookthumb.phinf.naver.net/cover/100/075/10007513.jpg?type=m1&udate=20170105', 'author': '히가시노 게이고', 'price': '14800', 'discount': '13320', 'publisher': '현대문학', 'pubdate': '20160111', 'isbn': '8972757578 9788972757573', 'description': '인류의 미지의 영역에 도전한 히가시노 게이고의 80번째 작품!히가시노 게이고 작가 데뷔 30주년 기념작 『라플라스의 마녀』. 그동안 치밀한 트릭과 반전이 빛나는 본격 추리소설부터 우리 시대의 문제점을 파고든 사회파 작품, 서스펜스, 판타지, SF에 이르기까지 다양한 장르를 오가며 미스터리의 경계를... '}
주의하실 점은, 같은 ISBN에 복수의 결과가 나올 수 있다는 점입니다. 동일한 책인데 띠지를 바꿔서 출판한다거나 등으로 중복해서 등록되어 있는 경우가 종종 있기 때문입니다.
이상으로 간단한 네이버 북 API에 대한 설명을 마칩니다.
