OpenAPI 안내

OpenAPI 안내

(최종 수정일 : 2022.7.13)

• OpenAPI는 크게 3가지로 나눠집니다.
  (1) 검색API
  (2) 상품API (하나의 상품을 열람하는 API)
  (3) 상품 리스트 API (베스트셀러 등 각종 상품 리스트 API)
  
• 상품API는 하나의 상품만을 열람하므로 검색API의 결과보다 자세한 부가 정보가 더해진 결과가 나옵니다.
• 검색API/상품API/리스트API의 결과는 모두 XML형식(기본값), json형식 형식으로 받으실 수 있습니다.
• 요청방식은 GET방식과 POST방식에 상관없이 요청 가능합니다.
• OpenAPI는 1일 5,000회로 제한됩니다. 5,000회 이상을 원하시는 분은 OpenAPI 이용 안내를 참고해주세요.
• 이전버젼(20070901)의 문서는 여기를 참고해주세요.
• OpenAPI 이용 매뉴얼☞
• 분류 ID값은 알라딘 모든 분야 카테고리 엑셀문서를 참고하십시오.(최종 수정일 : 2019.4.25)

상품 리스트 API

제공 리스트 종류

• 신간 전체 리스트
• 주목한 만한 신간 리스트
• 편집자 추천 리스트(카테고리로만 조회 가능 - 국내도서/음반/외서 만 지원)
• 베스트셀러
• 북플 베스트셀러(국내도서 만 조회 가능)

요청 방법

• 요청 URL : http://www.aladin.co.kr/ttb/api/ItemList.aspx
• 요청 URL샘플 : http://www.aladin.co.kr/ttb/api/ItemList.aspx?ttbkey=TTBKey&QueryType=ItemNewAll&MaxResults=10&start=1&SearchTarget=Book&output=xml&Version=20131101
• 결과샘플
  XML형식 : http://www.aladin.co.kr/ttb/api/test/ItemList_20131101.xml
  javascript형식 : http://www.aladin.co.kr/ttb/api/test/ItemList_20131101.js
• 총 결과는 1,000개까지만 조회 가능

API 키 발급 및 URL 등록하기☞