OpenAPI 안내

OpenAPI 안내

OpenAPI 서비스를 종료합니다.
ㅤ
1. 서비스 종료 대상
   -  알라딘 OpenAPI를 통해 제공되는 도서 검색 및 도서정보 API 전체

2. 서비스 종료 일정ㅤ
   - 신규 OpenAPI 인증키 및 프리미엄API 신청 종료 : 2026년 9월 4일
   - 기존 이용자 OpenAPI 서비스 종료 : 2026년 10월 30일

서비스 종료일인 10월30일 이후에는 기존 인증키를 이용한 API 호출 및 데이터 조회가 불가능합니다.

--------

• 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 이용 매뉴얼
• 알라딘 전체 카테고리 분류정보는 구글 시트를 참고하십시오.(최종 수정일 : 2026.3.16)

상품 리스트 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 등록하기☞