CMS솔루션마켓, 이온디 - 워드프레스, 라이믹스, 카페24, 그누보드, 엑셀

웹기술을 같이 공유합니다

Home WEB 웹팁

네이버 오픈API 책검색

이온디
2007년 09월 17일


제목뿐만 아니라 저자, 출판사, 카테고리별 검색 등 다양한 옵션이 제공되는 책 검색결과 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
정의되지 않은 오류가 발생하였습니다.

추천한 사람

 
댓글은 로그인 사용자만 작성 가능합니다. 로그인하기