도매꾹 Open API

소개
API 키 발급/관리
API 문서
공지사항

상품리스트

주어진 조건에 맞는 판매중 상품 목록을 반환하는 API입니다

API 정보

주어진 조건에 맞는 판매중 상품 목록을 반환하는 API입니다.

응답 결과는 동일한 검색조건으로 도매꾹·도매매 웹에서 조회한 상품 목록과 동일하며,

판매중지·판매종료·품절·단종 상품은 포함되지 않습니다.

상품리스트_4.1 ver (권장)

권장 ver: 4.1

Mode: getItemList

Method: GET

Endpoint: https://domeggook.com/ssl/api/

Request Example:

https://domeggook.com/ssl/api/?ver=4.1&mode=getItemList&aid={API_KEY}&market=dome&om=json&kw=마스크&sz=50&pg=1&so=rd

상품목록 검색을 위하여 아래 검색 조건 중 하나 이상의 파라미터 설정이 필요합니다.

  • 기획전번호 (ev), 카테고리 (ca), 아이디(id), 검색어(kw), 상품번호(itemNo))

Request

순서

항목( 자료형, 필수여부)

설명

1

ver (string,Y) 

API Version

2

mode (string,Y) 

API 호출 모드값 : getItemList

3

aid (string,Y) 

API Key

4

market (string,Y) 

서비스 코드

· dome : 도매꾹

· supply : 도매매

5

om (string,Y) 

출력 형식 : json | xml

6

sz (int,N) 

페이지당 상품 출력개수

· 1 이상 200 이하의 정수를 입력

· 미입력시 20이 기본값

7

pg (int,N) 

페이지 번호

8

so (string,N) 

검색결과 정렬방식

· se : 정확도순 (검색어 사용시 외에는 사용불가 / 검색어 사용시 기본값)

· rd : 도매꾹랭킹순 (검색어 미사용시 기본값)

· ha : 인기상품순

· aa : 낮은가격순

· ad : 높은가격순

· sd : 신규판매자순

· qa : 적은판매단위순

· qd : 많은판매단위순

· da : 최근등록순(상품정보등록/수정일 최근순)

9

ev (int,N) 

기획전 번호

· 특정 기획전에 속한 상품을 검색할 때에만 입력

· market값이 "dome"일 때에만 적용됨

10

ca (string,N) 

카테고리 검색

· 2자리의 숫자쌍 5개가 언더 바(_)로 연결된 형태로 입력

　ex) 01_01_00_00_00

· 미입력시, 모든 카테고리의 상품을 검색

· 카테고리 값이 잘못 입력된 경우, 미입력한 것으로 간주함

· 대분류만으로 검색할 수 없으며, 중분류 이하로 검색 가능함

ex) 01_00_00_00_00 검색 불가 , 01_11_00_00_00 검색 가능

11

id (string,N) 

판매자 아이디 검색

12

nick (string,N) 

판매자 닉네임 검색

13

kw (string,N) 

검색어 검색

14

mnp (int,N) 

가격대 검색 / 최저가격대

15

mxp (int,N) 

가격대 검색 / 최고가격대

※ mnp에 입력된 값보다 작은 값을 입력한 경우, mxp 값은 미입력한 것으로 간주함

16

mnq (int,N) 

최소구매수량 검색 / 최저수량

17

mxq (int,N) 

최소구매수량 검색 / 최대수량

※ mnq에 입력된 값보다 작은 값을 입력한 경우, mxq 값은 미입력한 것으로 간주함

18

who (string,N) 

배송비 부담

· S : 무료배송 상품만 검색

· B : 착불 상품만 검색

· P : 배송비 선결제 상품만 검색

· C : 선결제/착불 선택가능 상품만 검색

19

org (string,N) 

국산 여부

· kr : 국내산 상품만 검색

· fr : 국외산 상품만 검색

· 이 외의 값이 입력된 경우, 미입력한 것으로 간주함

20

sgd (boolean,N) 

우수판매자 상품 검색

· true : 우수판매자 상품만 검색

· false : 전체상품 검색 (기본값)

21

fdl (boolean,N) 

빠른배송 상품 검색

· true : 빠른배송 상품만 검색

· false : 전체상품 검색 (기본값)

22

lwp (boolean,N) 

최저가확인상품

· true : 최저가확인상품만 검색

· false : 전체상품 검색 (기본값)

23

dfos (boolean,N) 

해외직배송 상품 검색

· true : 해외직배송 상품만 검색

· false : 해외직배송 제외 상품 검색

· null : 전체상품 검색 (기본값)

24

itemNo (int,N) 

상품번호 검색

Response

순서

항목

자료형

설명

1

header

-

검색건수 및 페이지네이션 정보

2

header.numberOfItems

int

전체 상품의 수

3

header.firstItem

int

페이지 처음 상품 번호

4

header.lastItem

int

페이지 마지막 상품 번호

5

header.currentPage

int

현재 페이지

6

header.itemsPerPage

int

페이지 당 상품 수

7

header.numberOfPages

int

전체 페이지 수

8

header.sort

string

정렬방식

9

_

int

10

list.item

-

상품정보

11

list.item.no

int

상품번호

12

list.item.title

string

상품제목

13

list.item.price

int

상품단가

14

list.item.priceOrg

int

할인 전 단가

※ 사업자전용상품인 경우에만 표시됨

15

list.item.thumb

string

상품 썸네일 이미지 URL

16

list.item.idxCOM

int

상품에 사용한 유료등록옵션

· 0 : 포토포커스

· 1 : 프리미엄

· 2 : 우대등록

· 3 : 기본등록 (유료등록옵션 미사용)

17

list.item.id

string

판매자의 아이디

18

list.item.nick

string

판매자의 닉네임

※ 닉네임이 없는 경우, 본 요소에 아이디 값이 대체되어 표시됨

19

list.item.unitQty

int

상품 최소구매수량(MoQ)

20

list.item.comOnly

boolean

사업자전용상품 여부

· true : 사업자회원만 구매가능

· false : 모든 회원이 구매가능

21

list.item.adultOnly

boolean

성인전용상품 여부

· true : 만 19세 이상인 회원만 구매가능

· false : 모든 회원이 구매가능

22

list.item.lwp

boolean

최저가확인 상품 여부

· true : 최저가확인 상품

· false : 최저가 확인이 이루어지지 않은 상품

23

list.item.deli

-

배송 관련 정보

24

list.item.deli.who

string

배송비 부담

· S : 무료배송

· P : 선결제

· B : 착불

· C : 구매자선택 (착불/선결제)

25

list.item.deli.fee

string

배송비 금액

26

list.item.deli.add

boolean

구매수량에 따른 배송비 금액의 추가가능 여부

· true : 구매수량이 늘어남에 따라 배송비 금액이 증가하는 상품

· false : 구매수량과 관계없이 배송비 금액이 동일한 상품

※ 단, 이 값이 false라도 도서산간 지역의 경우에는 추가배송비가 있을 수 있음

27

list.item.deli.fromOversea

boolean

해외직배송 상품(해외에서 출고되어 배송수령지로 직배송되는 상품)인지 여부

· true : 해외직배송 상품

· false : 해당 없음

28

list.item.url

string

상품 URL

29

list.item.market.domeggook

boolean

도매꾹 true: 판매중, false: 판매중아님

30

list.item.market.supply

boolean

도매매 true: 판매중, false: 판매중아님

Response 예시

JSON

상품리스트_4.0 ver

Request

순서

항목( 자료형, 필수여부)

설명

1

ver (string,Y) 

API Version

2

mode (string,Y) 

API 호출 모드값 : getItemList

3

aid (string,Y) 

API Key

4

market (string,Y) 

서비스 코드

· dome : 도매꾹

· supply : 도매매

5

om (string,Y) 

출력 형식 : json | xml

6

sz (int,N) 

페이지당 상품 출력개수

· 1 이상 200 이하의 정수를 입력

· 미입력시 20이 기본값

7

pg (int,N) 

페이지 번호

8

so (string,N) 

검색결과 정렬방식

· se : 정확도순 (검색어 사용시 외에는 사용불가 / 검색어 사용시 기본값)

· rd : 도매꾹랭킹순 (검색어 미사용시 기본값)

· ha : 인기상품순

· aa : 낮은가격순

· ad : 높은가격순

· sd : 신규판매자순

· qa : 적은판매단위순

· qd : 많은판매단위순

· da : 최근등록순(상품정보등록/수정일 최근순)

9

ev (int,N) 

기획전 번호

· 특정 기획전에 속한 상품을 검색할 때에만 입력

· market값이 "dome"일 때에만 적용됨

10

ca (string,N) 

카테고리 검색

· 2자리의 숫자쌍 5개가 언더 바(_)로 연결된 형태로 입력

　ex) 01_01_00_00_00

· 미입력시, 모든 카테고리의 상품을 검색

· 카테고리 값이 잘못 입력된 경우, 미입력한 것으로 간주함

11

id (string,N) 

판매자 아이디 검색

12

kw (string,N) 

검색어 검색

13

mnp (int,N) 

가격대 검색 / 최저가격대

14

mxp (int,N) 

가격대 검색 / 최고가격대

※ mnp에 입력된 값보다 작은 값을 입력한 경우, mxp 값은 미입력한 것으로 간주함

15

mnq (int,N) 

최소구매수량 검색 / 최저수량

16

mxq (int,N) 

최소구매수량 검색 / 최대수량

※ mnq에 입력된 값보다 작은 값을 입력한 경우, mxq 값은 미입력한 것으로 간주함

17

who (string,N) 

배송비 부담

· S : 무료배송 상품만 검색

· B : 착불 상품만 검색

· P : 배송비 선결제 상품만 검색

· C : 선결제/착불 선택가능 상품만 검색

18

org (string,N) 

국산 여부

· kr : 국내산 상품만 검색

· fr : 국외산 상품만 검색

· 이 외의 값이 입력된 경우, 미입력한 것으로 간주함

19

sgd (boolean,N) 

우수판매자 상품 검색

· true : 우수판매자 상품만 검색

· false : 전체상품 검색 (기본값)

20

fdl (boolean,N) 

빠른배송 상품 검색

· true : 빠른배송 상품만 검색

· false : 전체상품 검색 (기본값)

21

itemNo (int,N) 

상품번호 검색

Response

순서

항목

자료형

설명

1

header

-

검색건수 및 페이지네이션 정보

2

header.numberOfItems

int

전체 상품의 수

3

header.firstItem

int

페이지 처음 상품 번호

4

header.lastItem

int

페이지 마지막 상품 번호

5

header.currentPage

int

현재 페이지

6

header.itemsPerPage

int

페이지 당 상품 수

7

header.numberOfPages

int

전체 페이지 수

8

header.sort

string

정렬방식

9

_

int

10

list.item

-

상품정보

11

list.item.no

int

상품번호

12

list.item.title

string

상품제목

13

list.item.price

int

상품단가

14

list.item.priceOrg

int

할인 전 단가

※ 사업자전용상품인 경우에만 표시됨

15

list.item.thumb

string

상품 썸네일 이미지 URL

16

list.item.idxCOM

int

상품에 사용한 유료등록옵션

· 0 : 포토포커스

· 1 : 프리미엄

· 2 : 우대등록

· 3 : 기본등록 (유료등록옵션 미사용)

17

list.item.id

string

판매자의 아이디

18

list.item.nick

string

판매자의 닉네임

※ 닉네임이 없는 경우, 본 요소에 아이디 값이 대체되어 표시됨

19

list.item.unitQty

int

상품 최소구매수량(MoQ)

20

list.item.comOnly

boolean

사업자전용상품 여부

· true : 사업자회원만 구매가능

· false : 모든 회원이 구매가능

21

list.item.adultOnly

boolean

성인전용상품 여부

· true : 만 19세 이상인 회원만 구매가능

· false : 모든 회원이 구매가능

22

list.item.lwp

boolean

최저가확인 상품 여부

· true : 최저가확인 상품

· false : 최저가 확인이 이루어지지 않은 상품

23

list.item.deli

-

배송 관련 정보

24

list.item.deli.who

string

배송비 부담

· S : 무료배송

· P : 선결제

· B : 착불

· C : 구매자선택 (착불/선결제)

25

list.item.deli.fee

string

배송비 금액

26

list.item.deli.add

boolean

구매수량에 따른 배송비 금액의 추가가능 여부

· true : 구매수량이 늘어남에 따라 배송비 금액이 증가하는 상품

· false : 구매수량과 관계없이 배송비 금액이 동일한 상품

※ 단, 이 값이 false라도 도서산간 지역의 경우에는 추가배송비가 있을 수 있음

27

list.item.deli.fromOversea

boolean

해외직배송 상품(해외에서 출고되어 배송수령지로 직배송되는 상품)인지 여부

· true : 해외직배송 상품

· false : 해당 없음

28

list.item.url

string

상품 URL

29

list.item.market.domeggook

boolean

도매꾹 true: 판매중, false: 판매중아님

30

list.item.market.supply

boolean

도매매 true: 판매중, false: 판매중아님

Response 예시

Plaintext
<domeggook>
	<header>
		<numberOfItems>50858</numberOfItems>
		<firstItem>1</firstItem>
		<lastItem>2</lastItem>
		<currentPage>1</currentPage>
		<itemsPerPage>2</itemsPerPage>
		<numberOfPages>25429</numberOfPages>
		<sort>rd</sort>
	</header>
	<list>
		<item>
			<no>7276212</no>
			<title><![CDATA[ [르시아] U자형 컬러 바디필로우 3100mm(CN7099) ]]></title>
			<thumb><![CDATA[
			http://211.43.195.137//upload/item/2017/06/13/149734448280D07EB8C329B5AA19C4F5/149734448280D07EB8C329B5AA19C4F5_stt_330.png
			]]></thumb>
			<id>cktrader</id>
			<price>21200</price>
			<unitQty>1</unitQty>
			<comOnly>true</comOnly>
			<adultOnly>false</adultOnly>
			<deli>
				<who>P</who>
				<fee>2500</fee>
				<add>true</add>
				<fromOversea>false</fromOversea>
			</deli>
			<url><![CDATA[ http://domeme.com/s/7276212 ]]></url>
		</item>
		<item>
			<no>7401196</no>
			<title><![CDATA[ [하이뷰] 17818/국내제작/메이드쁘띠스카프9종/반다나 ]]></title>
			<thumb><![CDATA[
			http://211.43.195.137//upload/item/2017/08/18/1503049058AF8BC4E850E292A918D97C/1503049058AF8BC4E850E292A918D97C_stt_330.png
			]]></thumb>
			<id>trendview</id>
			<nick>닉네임</nick>
			<price>3770</price>
			<unitQty>1</unitQty>
			<comOnly>true</comOnly>
			<deli>
				<who>C</who>
				<fee>2500</fee>
				<add>false</add>
			</deli>
			<url><![CDATA[ http://domeme.com/s/7401196 ]]></url>
			<market>
				<domeggook>true</domeggook>
				<supply>true</supply>
			</market>
		</item>
	</list>
</domeggook>

버전기록

버전 기록

  • v4.0 (권장/베이스) : Request/Response 구조 전면 개편(표준 파라미터·응답 포맷으로 변경) — 기존 연동 수정 필요

  • v4.1 (지원): nick 검색 + lwp/dfos 필터 추가 — 호환 영향 낮음(조치 없음)