인터파크도서에 제공하는 책 검색 Open API 입니다. 다양한 방식의 검색을 통해 책에 대한 다양한 정보를 제공하고 있습니다. 이 API를 통해 나만의 서재, 많은 사람들과 함께 책 이야기를 만들어 보세요.

 

1. 요청 URL (request url)

http://book.interpark.com/api/search.api

2-1. 요청 변수 (request parameter)

요청 변수 값 설명
key string (필수) 이용 등록을 통해 받은 인증키를 입력합니다.
query string (필수) 검색어를 입력합니다.
상세 검색에서 각 요청 변수의 기본 값을 기준으로 검색결과를 표시합니다.

샘플 URL

'삼국지'를 검색할 경우 :

http://book.interpark.com/api/search.api?key=interpark&query=%EC%82%BC%EA%B5%AD%EC%A7%80

2-2. 상세 검색-요청 변수 (request parameter)

※ 상세 검색은 검색 필수 사항을 보자 세부적으로 설정하여 검색할 수 있도록 합니다.

요청 변수 변수 옵션 설명
queryType title(기본값) : 제목검색
author : 저자검색
publisher : 출판사검색
isbn : Isbn검색
productNumber : 상품번호
all : 제목, 저자, 출판사,ISBN 검색 대상		 검색어 종류에 따른 세부 설정을 합니다.
searchTarget book(기본값) : 국내도서
foreign : 외국도서
cd : 음반
dvd : DVD		 검색하고자 하는 상품 구분을 설정합니다.
start 1이상, 양의 정수(기본값:1) 검색 결과의 시작 페이지의 페이지 번호를 설정합니다.
maxResults 1이상 100이하, 양의 정수(기본값:10) 검색 결과의 한페이지당 최대 출력 개수를 설정합니다.
sort accuracy(기본값) : 정확도순
publishTime : 출간일
title : 제목
salesPoint : 판매량
customerRating : 고객평점
reviewCount : 리뷰갯수
price : 가격오름순
priceDesc : 가격내림순
 검색 결과의 정렬 방법을 설정합니다.
categoryId

분야의 고유 번호(기본값:100 )

카테고리 다운로드

 지정한 카테고리에서만 검색 되도록 설정합니다.
* searchTarget를 설정 하였을 경우, searchTarget의 변수종류 하위에 속하지 않는 분야번호는 검색되지 않습니다.
output xml(기본값) : REST XML형식
json : JSON방식
 검색 결과의 출력 방식을 설정합니다.
inputEncoding utf-8(기본값)
euc-kr
 검색의의 인코팅 값을 설정합니다.
callback javascript function이름 호출후 불려질 javascript function의 이름을 지정합니다.
* output이 json인 경우에 한해 작동됩니다.
adultImageExposure n(기본값) : 노출안함
y : 노출함		 성인 이미지의 노출 여부를 설정합니다.
soldOut y(기본값) : 품절/절판함께보기
n : 품절/절판빼고보기

 품절/절판 상품 노출 여부를 설정합니다.

샘플 URL

검색어 인코딩 방식 변경하여 검색하기
http://book.interpark.com/api/search.api?key=interpark&query=시크릿&inputEncoding=euc-kr

 

ISBN으로 검색하기
http://book.interpark.com/api/search.api?key=interpark&query=9788992717199&queryType=isbn

 

페이지 설정하여 검색하기
http://book.interpark.com/api/search.api?key=interpark&query=시크릿&start=3&maxResults=50&inputEncoding=euc-kr

 

카테고리(국내도서-소설)로 검색하기
http://book.interpark.com/api/search.api?key=interpark&query=시크릿&inputEncoding=euc-kr&categoryId=101

 

 

3. 출력 결과 필드 (response field)

요청 변수 값 설명
title 문자열 검색 결과 페이지의 제목을 표시함니다.
link 문자열(URL) 검색 결과를 확인 할 수 있는 페이지 주소(URL)을 표시합니다.
imageUrl 문자열(URL) 제공자의 이미지 주소(URL)을 표시합니다.
language 문자열 겸색 결과의 언어를 표시합니다.
copyright 문자열 API 제공자의 Copyright를 표시합니다.
pubDate 날짜 검색 결과를 생성한 시간을 표시합니다.. (GMT 기준시)
totalResults 숫자 총 검색 결과의 개 수를 표시합니다.
startIndex

숫자

 현재의 페이지 번호를 표시합니다.
itemsPerPage 숫자 한 페이지당 표시되는 검색 결과 개수를 표시합니다.
maxResults 숫자 검색을 요청한 페이지당 결과 개수를 표시합니다.
query 문자열 검색을 요청한 쿼리(검색어)를 표시합니다.
searchCategoryId 숫자 검색 결과를 요청한 카테고리의 아이디값을 표시합니다.
searchCategoryName 문자열 검색 결과를 요청한 카테고리의 이름을 표시합니다.
returnCode 숫자 오류메시지의 코드를 표시합니다.
returnMessage 문자열 오류메시지를 표시합니다.
item < itemId 숫자 검색 상품의 고유번호를 표시합니다.(상품번호)
item < title 문자열 검색 상품의 이름을 표시함니다.
item < isbn 문자열 검색 상품의 ISBN을 표시합니다.
item < url 문자열(URL) 검색 상품의 주소(URL)을 표시합니다.
※ '고맙습니다' 적립 : 주소에 "&key=인증키"를 추가하여야 합니다.
item < author 문자열 검색 상품의 저자(음악일 경우 가수, DVD일 경우 감독)를 표시합니다.
item < translator 문자열 검색 상품의 역자(DVD일 경우 배우)를 표시합니다.
item < description 문자열 검색 상품의 설명을 표시합니다. (HTML 제외)
item < priceStandard 숫자(통화) 검색 상품의 정가를 표시합니다.
item < priceSales 숫자(통화) 검생 상품의 판매가를 표시합니다. (수시로 변동 될 수 있습니다.)
item < discountRate 숫자 검색 상품의 할인율을 표시합니다. (단위 %)
item < saleStatus 문자열 검색 상품의 판매 상태를 표시합니다.
item < mileage 숫자(통화) 검색 상품의 상품 구매시 지급되는 마일리지를 표시합니다.
item < mileageRate 숫자 검색 상품의 상품 구매시 지급되는 마일리지율을 표시합니다.(단위 %)
item < coverSmallUrl 문자열(URL) 검색 상품의 작은 사이즈 이미지를 표시합니다.
item < coverLargeUrl 문자열(URL) 검색 상품의 큰 사이즈 아미지를 표시합니다.
item < categoryId 숫자 검색 상품이 속한 카테고리의 아이디값을 표시합니다.
item < categoryName 문자열 검색 상품이 속한 카테고리의 이름을 표시합니다.
item < publisher 문자열 검색 상품의 출판사(제작사)를 표시합니다.
item < pubDate 문자열 검색 상품의 출간일(등록일)을 표시합니다.

4. 비고/에러 메시지

에러코드 에러 메시지
000 정상
001 시스템 에러
101 등록되지 않은 키입니다.
102 사용할 수 없는 키입니다.
OpenAPI에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 쿼리를 검색하는 경우 발생하는 에러입니다.
201 authKey 파라미터가 없습니다.
202 query 파라미터가 없습니다.
203 categoryId 파라미터가 없습니다.
301 부적절한 queryType값입니다.
302 부적절한 searchTarget 값입니다.
303 부적절한 start 값입니다.
304 부적절한 maxResults 값입니다.
305 부적절한 adultImageExposure 값입니다.
306 부적절한 query 값입니다. queryType이 productNumber일 경우 숫자로 설정해야 합니다.
307 정의되지 않은 sort값입니다.
308 정의되지 않은 categoryId 값입니다.
309 정의되지 않은 output 값입니다.
310 정의되지 않은 inputEncoding 값입니다.
311 정의되지 않은 soldOut 값입니다.
400 1일접속제한을 초과하였습니다.
401 정보가 존재하지 않습니다.