알라딘 OPEN API 사용법

박지원·2024년 9월 12일

사용 방법

1) 알라딘 회원 가입 후 OpenAPI를 사용할 URL정보를 등록해주세요.
알라딘 API를 이용하려면 먼저 TTB Key를 발급받아야 한다.

알라딘 Open API 주소

2) URL 정보 등록이 완료되면 OpenAPI 인증키가 발급되며 즉시 사용이 가능합니다.

이렇게 등록된 URL 목록에서 인증키를 확인할 수 있다

3) 하루 쿼리 호출수는 5천건으로 제한됩니다.
나는 하루에 5천건 이하로 진행될것 같아서 따로 프리미엄을 신청하지는 않았다. 더 자세히 보길 원하면 링크 를 클릭!

API

알라딘 OPEN API 는 총 4개의 API 를 제공한다
1) 상품 검색 API
2) 상품 리스트 API
3) 상품 조회 API
4) 중고상품 보유 매장 검색 API

더 자세한 API 문서

상품 검색 API

요청 URL : http://www.aladin.co.kr/ttb/api/ItemSearch.aspx
요청 URL샘플 : http://www.aladin.co.kr/ttb/api/ItemSearch.aspx?ttbkey=[TTBKey]&Query=aladdin&QueryType=Title&MaxResults=10&start=1&SearchTarget=Book&output=xml&Version=20131101

요청 URL 에 필수값으로 ttbkey 와 Query 검색어가 들어가야한다.

상품 검색 API와 상품 리스트 API 의 차이점!

  1. 상품 검색 API는 '검색어'를 통한 입력, 상품 리스트 API 는 제공하는 리스트 중 선택
  2. 검색어 타입은 제목+저자 ,제목검색, 저자검색, 출판사검색 등이 있다

즉, 책의 제목또는 저자로 검색하여 책을 찾고 싶을 때는 상품 검색 API 사용하고, 신간 리스트, 추천 리스트 등 책의 리스트에서 옵션을 주어 필터링을 하여 검색할 때는 상품 리스트 API 를 사용한다.

나는 특정 카테고리를 선택했을 때 그에 대한 책 추천도 생각했기 떄문에 상품 리스트 API 를 적용해야 겠다고 생각했다.

상품 리스트 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

상품 조회 API

요청 URL : http://www.aladin.co.kr/ttb/api/ItemLookUp.aspx
요청 URL샘플 : http://www.aladin.co.kr/ttb/api/ItemLookUp.aspx?ttbkey=[TTBKey]&itemIdType=ISBN&ItemId=[도서의ISBN]&output=xml&Version=20131101&OptResult=ebookList,usedList,reviewList

  • "상품 조회 응답(Reponse) 결과값"의 스펙은 "검색 응답(Reponse) 결과값"과 동일한 결과에 단순히 부가정보가 추가되어지는 것임.
  • 상품에 대한 ISBN 또는 알라딘 책 ID롤 검색할 시 활용하며, 감품 검색 보다 세부적인 정보를 얻을 수 있다.

알라딘 OPEN API 문서

0개의 댓글