상품리스트

Request

순서 항목 자료형 필수 여부 설명
1 ver string Y API Version / 항상 "4.0"을 입력
2 mode string Y API 호출 모드값 / 항상 "getItemList"을 입력
3 aid string Y API Key
4 market string Y 서비스 코드
· dome : 도매꾹
· supply : 도매매
5 sz int N 페이지당 상품 출력개수
· 1 이상 200 이하의 정수를 입력
· 미입력시 20이 기본값
6 pg int N 페이지 번호
7 so string N 검색결과 정렬방식
· se : 정확도순 (검색어 사용시 외에는 사용불가 / 검색어 사용시 기본값)
· rd : 도매꾹랭킹순 (검색어 미사용시 기본값)
· ha : 인기상품순
· aa : 낮은가격순
· ad : 높은가격순
· sd : 신규판매자순
· qa : 적은판매단위순
· qd : 많은판매단위순
· da : 최근등록순(상품정보등록/수정일 최근순)
8 ev int N 기획전 번호
· 특정 기획전에 속한 상품을 검색할 때에만 입력
· market값이 "dome"일 때에만 적용됨
9 ca string N 카테고리 검색
· 2자리의 숫자쌍 5개가 언더 바(_)로 연결된 형태로 입력
 ex) 01_01_00_00_00
· 미입력시, 모든 카테고리의 상품을 검색
· 카테고리 값이 잘못 입력된 경우, 미입력한 것으로 간주함
10 id string N 판매자 아이디 검색
11 kw string N 검색어 검색
12 mnp int N 가격대 검색 / 최저가격대
13 mxp int N 가격대 검색 / 최고가격대
※ mnp에 입력된 값보다 작은 값을 입력한 경우, mxp 값은 미입력한 것으로 간주함
14 mnq int N 최소구매수량 검색 / 최저수량
15 mxq int N 최소구매수량 검색 / 최대수량
※ mnq에 입력된 값보다 작은 값을 입력한 경우, mxq 값은 미입력한 것으로 간주함
16 who string N 배송비 부담
· S : 무료배송 상품만 검색
· B : 착불 상품만 검색
· P : 배송비 선결제 상품만 검색
· C : 선결제/착불 선택가능 상품만 검색
17 org string N 국산 여부
· kr : 국내산 상품만 검색
· fr : 국외산 상품만 검색
· 이 외의 값이 입력된 경우, 미입력한 것으로 간주함
18 sgd boolean N 우수판매자 상품 검색
· true : 우수판매자 상품만 검색
· false : 전체상품 검색 (기본값)
19 fdl boolean N 빠른배송 상품 검색
· true : 빠른배송 상품만 검색
· false : 전체상품 검색 (기본값)

Response

순서 항목 자료형 설명
1 domeggook.header - 검색건수 및 페이지네이션 정보
2 domeggook.header.numberOfItems int 전체 상품의 수
3 domeggook.header.firstItem int 페이지 처음 상품 번호
4 domeggook.header.lastItem int 페이지 마지막 상품 번호
5 domeggook.header.currentPage int 현재 페이지
6 domeggook.header.itemsPerPage int 페이지 당 상품 수
7 domeggook.header.numberOfPages int 전체 페이지 수
8 domeggook.header.sort string 정렬방식
9 _ int ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
10 domeggook.item - 상품정보
11 domeggook.item.no int 상품번호
12 domeggook.item.title string 상품제목
13 domeggook.item.price int 상품단가
14 domeggook.item.priceOrg int 할인 전 단가
※ 사업자전용상품인 경우에만 표시됨
15 domeggook.item.thumb string 상품 썸네일 이미지 URL
16 domeggook.item.idxCOM int 상품에 사용한 유료등록옵션
· 0 : 포토포커스
· 1 : 프리미엄
· 2 : 우대등록
· 3 : 기본등록 (유료등록옵션 미사용)
17 domeggook.item.id string 판매자의 아이디
18 domeggook.item.unitQty int 상품 최소구매수량(MoQ)
19 domeggook.item.comOnly boolean 사업자전용상품 여부
· true : 사업자회원만 구매가능
· false : 모든 회원이 구매가능
20 domeggook.item.adultOnly boolean 성인전용상품 여부
· true : 만 19세 이상인 회원만 구매가능
· false : 모든 회원이 구매가능
21 domeggook.item.lwp boolean 최저가확인 상품 여부
· true : 최저가확인 상품
· false : 최저가 확인이 이루어지지 않은 상품
22 domeggook.item.deli - 배송 관련 정보
23 domeggook.item.deli.who string 배송비 부담
· S : 무료배송
· P : 선결제
· B : 착불
· C : 구매자선택 (착불/선결제)
24 domeggook.item.deli.fee int 배송비 금액
25 domeggook.item.deli.add boolean 구매수량에 따른 배송비 금액의 추가가능 여부
· true : 구매수량이 늘어남에 따라 배송비 금액이 증가하는 상품
· false : 구매수량과 관계없이 배송비 금액이 동일한 상품
※ 단, 이 값이 false라도 도서산간 지역의 경우에는 추가배송비가 있을 수 있음
26 domeggook.item.deli.fromOversea boolean 해외직배송 상품(해외에서 출고되어 배송수령지로 직배송되는 상품)인지 여부
· true : 해외직배송 상품
· false : 해당 없음
27 domeggook.item.url string 상품 URL

Response 예시