[요청] 상품 조회 API 명세서

알라딘에 등록된 특정 상품(도서, 음반, DVD 등)의 상세 정보를 조회하기 위한 API입니다. 검색 결과값은 기본 검색 API와 동일한 구조를 가지며, 요청 시 추가 옵션에 따라 부가적인 정보를 함께 받아볼 수 있습니다.

---

1. 기본 정보

• 요청 URL: http://www.aladin.co.kr/ttb/api/ItemLookUp.aspx
• 응답 형식: XML, JSON (기본값: XML)
• 응답 결과: 검색 응답 결과값 스펙에 부가 정보가 추가된 형태

요청 샘플 (URL)

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

2. 상품 조회 API 요청(Request) 파라미터

구분	요청변수	변수종류	필수여부	설명
필수	TTBKey	문자열	Y	알라딘에서 부여받은 TTBKey 값
	ItemId	문자열/숫자	Y	상품을 구분 짓는 유일한 값 (ItemIdType에 따라 ISBN 또는 알라딘 고유 ID 입력)
옵션	ItemIdType	문자열	N	ISBN: ISBN 10자리 (기본값) ISBN13: ISBN 13자리 (권장) ItemId: 알라딘 고유의 상품 ID
	Cover	문자열	N	표지 크기 선택 - Big: 큰 크기 - MidBig: 중간 큰 크기 - Mid: 중간 크기 (기본값) - Small: 작은 크기 - Mini: 매우 작은 크기 - None: 없음
	Output	문자열	N	출력 방법 선택 - XML: REST XML 형식 (기본값) - JS: JSON 방식
	Partner	문자열	N	제휴사 파트너 코드 (제휴사 유효성 체크용)
	Version	정수형 날짜	N	검색 API 버전 설정 - 기본값: 20070901 - 최신버전: 20131101
	includeKey	양의 정수	N	1인 경우 결과 내 상품 링크에 TTBKey 포함 (기본값: 0)
	offCode	문자열	N	중고상품 보유 매장 검색 API에서 얻은 중고매장 코드
	OptResult	문자열	N	부가 정보 요청 (Array 형태, 쉼표로 구분) 예: OptResult=ebookList,usedList,reviewList

---

3. OptResult 상세 옵션 (상품 조회 전용)

OptResult 파라미터에 포함하여 더 상세한 정보를 받아올 수 있는 항목들입니다.

• ebookList: 해당 종이책의 전자책 정보
• usedList: 해당 상품에 등록된 중고상품 정보
• fileFormatList: 전자책의 포맷 및 용량
• c2binfo: 중고 C2B(알라딘 매입) 여부 및 매입가 조회
• packing: 판형 정보, 포장 관련 정보
• b2bSupply: 전자책 B2B 납품 가능 여부
• subbarcode: 부가기호
• cardReviewImgList: 카드리뷰 일부 이미지 경로
• ratingInfo: 상품 별점 평점, 100자평 개수, 마이리뷰 개수
• bestSellerRank: 상품의 주간 베스트셀러 순위
• previewImgList: 미리보기 이미지 경로 (추가 요청 시 제공 가능)
• eventList: 관련 이벤트 정보 (추가 요청 시 제공 가능)
• authors: 저자/아티스트 상세 정보 목록 (추가 요청 시 제공 가능)
• reviewList: 상품에 등록된 리뷰 목록 (추가 요청 시 제공 가능)
• fulldescription: 상품 설명 및 출판사 소개 (DVD는 줄거리 포함)
• fulldescription2: 출판사(제작사) 제공 상품 상세 소개
• Toc: 상품의 목차 (추가 요청 시 제공 가능)
• Story: 줄거리 (추가 요청 시 제공 가능)
• categoryIdList: 전체 분야 카테고리 목록 (추가 요청 시 제공 가능)
• mdrecommend: 편집장의 선택 (추가 요청 시 제공 가능)
• phraseList: 책속에서 (최대 3개 노출, 추가 요청 시 제공 가능)