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

 

1. 요청 URL (request url)

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

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

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

샘플 URL

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

https://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	정보가 존재하지 않습니다.

 

인터파크도서에 제공하는 베스트 셀러 Open API 입니다. 인터파크 도서에서 각 분야별 판매량을 기준으로 집계하여 제공됩니다.

 

1. 요청 URL (request url)

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

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

요청 변수	값	설명
key	string (필수)	이용 등록을 통해 받은 인증키를 입력합니다.
categoryId	분야의 고유 번호(필수)	지정한 카테고리의 베스트 셀러를 검색합니다.

샘플 URL

국내도서 전체의 베스트 셀러 보기

http://book.interpark.com/api/bestSeller.api?key=interpark&categoryId=100

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

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

요청 변수	변수 옵션	설명
output	xml(기본값) : REST XML형식 json : JSON방식	검색 결과의 출력 방식을 설정합니다.
callback	javascript function이름	호출후 불려질 javascript function의 이름을 지정합니다. * output이 json인 경우에 한해 작동됩니다.

샘플 URL

결과값을 XML로 출력하기
http://book.interpark.com/api/bestSeller.api?key=interpark&categoryId=100&output=xml

 

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	정보가 존재하지 않습니다.

 

인터파크도서에 제공하는 추천도서 Open API 입니다. 인터파크 도서에 등록되는 상품을 각 분야로 집계하여 제공됩니다.

 

1. 요청 URL (request url)

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

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

요청 변수	값	설명
key	string (필수)	이용 등록을 통해 받은 인증키를 입력합니다.
categoryId	분야의 고유 번호(필수)	지정한 카테고리의 베스트 셀러를 검색합니다.

샘플 URL

국내도서 전체의 신간도서 보기

http://book.interpark.com/api/recommend.api?key=interpark&categoryId=100

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

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

요청 변수	변수 옵션	설명
output	xml(기본값) : REST XML형식 json : JSON방식	검색 결과의 출력 방식을 설정합니다.
callback	javascript function이름	호출후 불려질 javascript function의 이름을 지정합니다. * output이 json인 경우에 한해 작동됩니다.

샘플 URL

결과값을 XML로 출력하기
http://book.interpark.com/api/recommend.api?key=interpark&categoryId=100&output=xml

 

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	정보가 존재하지 않습니다.

 

인터파크도서에 제공하는 신간도서 Open API 입니다. 인터파크 도서에 등록되는 상품을 각 분야로 집계하여 제공됩니다.

 

1. 요청 URL (request url)

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

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

요청 변수	값	설명
key	string (필수)	이용 등록을 통해 받은 인증키를 입력합니다.
categoryId	분야의 고유 번호(필수)	지정한 카테고리의 베스트 셀러를 검색합니다.

샘플 URL

국내도서 전체의 신간도서 보기

http://book.interpark.com/api/newBook.api?key=interpark&categoryId=100

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

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

요청 변수	변수 옵션	설명
output	xml(기본값) : REST XML형식 json : JSON방식	검색 결과의 출력 방식을 설정합니다.
callback	javascript function이름	호출후 불려질 javascript function의 이름을 지정합니다. * output이 json인 경우에 한해 작동됩니다.

샘플 URL

결과값을 XML로 출력하기
http://book.interpark.com/api/newBook.api?key=interpark&categoryId=100&output=xml

 

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	정보가 존재하지 않습니다.