DNA 포럼 API 서비스 모음 DNA Lens

책 검색 API


책 검색 API는 모든 도서 서비스에 대한 검색 결과를 외부 개발자 및 사용자에게 XML 형식으로 전달하는 API 서비스입니다. 다음 도서 서비스에서 제공되는 모든 도서에 대한 서지 정보 및 리뷰 본문검색 서비스를 제공할 수 있게 해 줍니다.

요청 주소(Request URL) #

http://apis.daum.net/search/book


요청 변수(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 교보문고 전자 책 바코드 정보

출력 방식 #

  • [http]XML 방식 출력
  • [http]RSS 방식 출력
  • [http]JSON 방식 출력
  • 본 API는 외부 자바스크립트에서 서비스를 이용할 수 있도록 [http]콜백(Callback)함수를 지원합니다.

오류 메시지 #

게시판 검색 API는 [http]표준 오류 메시지를 전달합니다.

트래픽 제한 #

게시판 검색 API는 하나의 키에 대해 하루 5,000회 호출을 허용합니다. 자세한 사항은 [http]트래픽 제한을 참조하세요.

예제 코드 #

Daum 오픈API는 각 언어별 아래 예제를 통해 이용하실 수 있습니다.

http://dna.daum.net/apis/howto-php http://dna.daum.net/apis/howto-python http://dna.daum.net/apis/howto-javascript http://dna.daum.net/apis/howto-flex