네이버 오픈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 4 / 57 pages

	제목		날짜
647	[기본] 구글 검색창 소스 [1]	4	2007/11/23
646	[GitHub] 간단한 깃 사용법	13	2021/02/01
645	[웹 제작] website to learn	44	2022/12/27
644	[사이트관리] 사이트맵 FAQ	50	2023/01/31
643	[MySQL] How to change a MySQL database’s table prefix	59	2020/02/18
642	카카오지도 가려지는 문제	59	2024/02/01
641	[Nginx] : /bin/bash^M: bad interpreter: No such file or directory	63	2017/10/28
640	[리눅스서버] 수천 개의 파일이 포함 된 큰 디렉토리를 효율적으로 삭제	64	2020/12/07
639	[웹 제작] 임시이미지 사이트 https://placeimg.com/	66	2022/11/27
638	[웹 제작] css hover underline center to side	67	2020/04/16
637	[윈도우] 윈도우 이 항목을 찾을 수 없습니다 삭제 방법	68	2020/11/29
636	[리눅스서버] 리눅스 iptables IP 차단	69	2020/04/16