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