책 검색 API
책 검색 API는 모든 도서 서비스에 대한 검색 결과를 외부 개발자 및 사용자에게 XML 형식으로 전달하는 API 서비스입니다. 다음 도서 서비스에서 제공되는 모든 도서에 대한 서지 정보 및 리뷰 본문검색 서비스를 제공할 수 있게 해 줍니다.
요청 변수(Request Parameters) #
| 요청 변수 | 값 | 설명 |
| q | string (필수) | 검색을 원하는 질의 |
| target | string : meta(기본값), content(추후지원예정), review(추후지원예정) | 검색할 대상 정보. meta는 서지, content는 본문, review는 리뷰를 검색합니다. 지금 서비스에서는 meta만 지원하며 content, review는 추후 지원 예정입니다 |
| cate_id | integer (Optional) | 검색 범위 카테고리를 지정. 카테고리 정보는 아래와 같습니다. 전체 카테고리를 검색하려면 이 파라미터를 사용하지 않으면 됩니다. * 소설 : 1 * 시/에세이/기행 : 3 * 인문 : 5 * 가>족/생활/요리 : 7 * 건강/의학 : 9 * 여행/취미 : 11 * 경영/경제 : 13 * 자기계발 : 15 * 사회/정치/법 : 17 * 역사/풍속/신화 : 19 * 종교 : 21 * 예술/대중문화 : 23 * 학습지/참고서 : 25 * 외국어 : 27 * 자연과학/>공학 : 29 * 수험서 : 31 * 컴퓨터/인터넷 : 33 * 잡지 : 35 * 사전 : 37 * 청소년 : 38 * 유아 : 41 * 아동 : 42 * 어린이영어 : 45 * 만화 : 47 * 기타 : 100 * 외국 : 101 * 일본 : 102 |
| result | integer : 기본값 10, 최소 1, 최대 20 | 한 페이지에 출력될 결과수 |
| pageno | integer : 기본값 1, 최소 1, 최대 500 | 검색 결과 페이지 번호 |
| sort | string : poplular(기본값), accu, date | 검색 결과의 정렬순서 * popular : 판매량순 * accu : 정확도순 * date : 최신자료순 |
| output | string : xml (기본값), rss, json | 출력방식 * xml 방식으로 제공 가능합니다. * rss 방식으로 제공 가능합니다. * json 방식으로 제공 가능합니다. |
| searchType | string : all(기본값), title, isbn, writer, publisher, keyword, overview, contents | all: 전체에서 검색 title: 책 제목에서 검색 isbn: isbn에서 검색 keyword: 주제어에서 검색 contents: 목차에서 검색 overview: 책 소개에서 검색 publisher: 출판사에서 검색 |
| callback | string | 콜백함수(output이 json일 경우) |
출력 결과(Response Elements) #
| 출력 변수 | 값 | 설명 |
| title | string | 검색 제목 |
| totalCount | integer | 전체 검색 결과의 수 |
| sort | string | 검색 결과의 정렬순 |
| result | integer | 한 페이지에 보여질 결과 수 |
| target | string | 검색 대상 |
| pageno | integer | 검색 결과의 페이지 번호 |
| elapsed_time | integer | 검색에 걸린 시간 |
| q | string | 검색어 |
| item | - | 개별 검색 결과 정보(아래에 설명) |
item #
| 출력 변수 | 값 | 설명 |
| title | string | 책 제목 |
| link | string | 책에 대한 페이지 link url |
| cover_s_url | string | 표지 이미지(small) |
| cover_l_url | string | 표지 이미지(large) |
| description | string | 책에 대한 설명 |
| author | string | 저자 |
| translator | string | 역자 |
| pub_nm | string | 출판사 |
| pub_date | string | 출판일 |
| category | string | 카테고리 정보 |
| isbn | string | ISBN 번호 |
| sale_yn | string | 판매 가능 여부 |
| list_price | string | 원가격 |
| sale_price | string | 판매가격 |
| status_des | string | 책의 현재 상태(정상,품절,절판 등) |
| barcode | string | 교보문고 바코드 정보 |
| ebook_barcode | string | 교보문고 전자 책 바코드 정보 |
출력 방식 #
XML 방식 출력
RSS 방식 출력
JSON 방식 출력
- 본 API는 외부 자바스크립트에서 서비스를 이용할 수 있도록
콜백(Callback)함수를 지원합니다.


