네이버 오픈API 책검색 - 아임웹 전문가찾기

Share Tips & Tech

각종 팁&정보를 나누는 곳입니다.
누군가에게 도움이 된다 싶으시면 언제라도 포스팅 :)

글 등록하기 | 내글 관리하기 | 연재글 | 보관함

네이버 오픈API 책검색

2007.09.17 06:35 조회 수

6784

이온디

첨부파일 https://imweb.eond.com/webtip/117658

제목뿐만 아니라 저자, 출판사, 카테고리별 검색 등 다양한 옵션이 제공되는 책 검색결과 API를 이용해 나만의 도서관을 만들어 보세요.

1. 요청 URL (request url)

http://openapi.naver.com/search

2-1. 요청 변수 (request parameter)


요청 변수	값	설명

key	string (필수)	이용 등록을 통해 받은 key 스트링을 입력합니다.

target	string (필수) : book	서비스를 위해서는 무조건 지정해야 합니다.

query	string (필수)	검색을 원하는 질의, UTF-8 인코딩 입니다.

display	integer : 기본값 10, 최대 100	검색결과 출력건수를 지정합니다. 최대 100 까지 가능합니다.

start	integer : 기본값 1, 최대 1000	검색의 시작위치를 지정할 수 있습니다. 최대 1000 까지 가능합니다.

샘플 URL

http://openapi.naver.com/search?key=test&query=go&display=10&start=1&target=book&sort=sim

2-2. 상세 검색-요청 변수 (request parameter)


요청 변수	값	설명

target	string (필수) : book_adv	상세검색을 위해서는 무조건 지정해야 합니다.

query	string (필수)	검색을 원하는 질의, UTF-8 인코딩 입니다.

d_titl	string	책 제목에서의 검색을 의미합니다.

d_auth	string	저자명에서의 검색을 의미합니다.

d_cont	string	목차에서의 검색을 의미합니다.

d_isbn	string	isbn에서의 검색을 의미합니다.

d_publ	string	출판사에서의 검색을 의미합니다.

d_dafr	integer (ex.20000203)	검색을 원하는 책의 출간 범위를 지정합니다. (시작일)

d_dato	integer (ex.20000203)	검색을 원하는 책의 출간 범위를 지정합니다. (종료일)

d_catg	integer	검색을 원하는 카테고리를 지정합니다.

display	integer : 기본값 10, 최대 100	검색결과 출력건수를 지정합니다. 최대 100 까지 가능합니다.

start	integer : 기본값 1, 최대 1000	검색의 시작위치를 지정할 수 있습니다. 최대 1000 까지 가능합니다.

샘플 URL

http://openapi.naver.com/search?key=test&query=art&display=10&start=1&target=book_adv&d_titl=art&d_catg=103

3. 출력 결과 필드 (response field)


필드	값	설명

rss	-	디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다.

channel	-	검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다.

lastBuildDate	datetime	검색 결과를 생성한 시간입니다.

total	integer	검색 결과 문서의 총 개수를 의미합니다.

start	integer	검색 결과 문서 중, 문서의 시작점을 의미합니다.

display	integer	검색된 검색 결과의 개수입니다.

item	-	개별 검색 결과이며, title, link, description을 포함합니다.

title	string	검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다.

link	string	검색 결과 문서의 하이퍼텍스트 link를 나타냅니다.

image	string	썸네일 이미지의 URL입니다. 이미지가 있는 경우만 나타납니다.

author	string	저자정보입니다.

price	integer	정가 정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다.

discount	integer	할인 가격정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다.

publisher	string	출판사 정보입니다.

pubdate	date	출간일 정보입니다.

isbn	integer	ISBN 넘버입니다.

description	string	검색 결과 문서의 내용을 요약한 패시지 정보입니다. 문서 전체의 내용은 link 를 따라가면, 읽을 수 있습니다. 패시지에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다.

샘플 페이지

4. 비고/에러 메시지

000 : System error
시스템 에러

010 : Your query request count is over the limit
쿼리요청 제한을 초과하였습니다. 일반적으로는 5,000개이상의 쿼리에 대하여 이 에러 메세지가 발생되나, 쿼리 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다.

011 : Incorrect query request
잘 못된 쿼리요청입니다. 쿼리(query=)필드 자체가 없는 경우 발생하는 에러 메세지 입니다. ...&query=& 식으로 입력하는 경우 정상적인 쿼리 요청으로 보고, 에러 메세지를 발생하지 않으며, "에 대한 검색을 수행합니다.

020 : Unregistered key
등록되지 않은 키입니다.

021 : Your key is temporary unavailable
사용할 수 없는 키입니다. OpenAPI에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 쿼리를 검색하는 경우 발생하는 에러입니다.

100 : Invalid target value
부적절한 target 값입니다. 필드 설명에 없는 target이름을 사용한 경우, 혹은 target필드가 없는 경우 발생하는 메세지입니다.

101 : Invalid display value
부 적절한 display 값입니다. display필드 자체가 없는 경우에는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, 기본값인 display=10으로 처리됩니다. display값이 100을 초과하는 경우나 0이하의 값일때, 혹은 '...&display=&'와 같이 값을 입력하지 않은 경우에는 에러 메세지를 발생합니다.

102 : Invalid start value
부 적절한 start 값입니다. start필드 자체가 없는 경우에는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, 기본값인 start=1으로 처리됩니다. start값이 1000을 초과하거나 0이하의 경우, 혹은 '...&start=&'와 같이 값을 입력하지 않은 경우에는 에러 메세지를 발생합니다.

110 : Undefined sort value
정 의되지 않은 sort값입니다. sort필드 자체가 없는 경우는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, sort 옵션을 사용하는 서비스 API인 경우 기본값인 sort=sim으로 처리됩니다. sort값이 해당하는 서비스의 정렬옵션 이외의 값을 가지는 경우 혹은 '...&sort=&'와 같이 값을 입력하지 않은 경우 에러 메세지를 발생합니다. ( 예, 지식iN 검색 쿼리 요청에서 쇼핑 검색의 정렬 옵션인 sort=asc를 사용하는 경우 )

200 : Reserved

900 : Undefined error occured
정의되지 않은 오류가 발생하였습니다.

Total 683 articles in 45 / 57 pages

	제목		날짜
155	[기본] 메일 사이트별 일반파일 첨부용량 가능사이즈	9663	2010/05/02
154	[기타] [mp3]구글에서 맘껏 받아 보아요 (by SelfEx>>)	9675	2005/03/05
153	[하드웨어] 소켓 939 보드 구하기	9692	2009/09/21
152	[사이트관리] 구글 url 긴급 삭제 요청(구글 검색 삭제) [1]	9700	2008/10/09
151	[웹로그] 아이튠즈를 업데이트 후 실행이 안될 때 [1]	9716	2007/11/21
150	[웹로그] 홈페이지 속도 개선	9745	2010/09/19
149	[웹로그] 입력폼과 이미지폼의 정렬은 어떻게 맞추나요?	9776	2007/11/09
148	[기본] 고스트 복원 후 해야할 일	9816	2009/12/02
147	[뉴스] 차단된 웹사이트는 이 방법으로 접속해주세요	9862	2020/01/29
146	[미디어/녹음·재생] 소리바다 MP 안 깍이는 꼼수 (by vivian) [1]	9877	2005/04/06
145	싸이월드 게시판에 동영상 및 음악 플레이어 삽입하기	9935	2008/08/01
144	[X61] 이제는 다시 브라우저 키로 글을 날려먹지 말자.	9942	2009/01/01