제품 API 참조 v1 (Legacy)

⚠️ Legacy: v1 API는 짧은 기간 동안만 병행 운영됩니다. 새 통합은 제품 API v2를 사용하세요.

요약

이 페이지는 제품 API v1의 매개변수와 값을 완전히 정리한 것입니다: Taobao와 1688에서 키워드 검색, 이미지 검색, 제품 상세 조회. 단계별로 따라 하려면 제품 검색 가이드를 참조하세요.

키워드로 제품 검색

자세히 보기: 제품 검색

POST /v1/products/search

언어 번역 (`lang`)

값	설명	Platform
vi	베트남어	✅ Taobao ✅ 1688
en	영어	✅ Taobao ✅ 1688

번역 데이터는 titleEn 키에 있습니다. title 키는 여전히 중국어 데이터입니다.

결과 정렬 (`sort`)

값	설명	Platform
PRICE_ASC	가격 오름차순	✅ Taobao ✅ 1688
PRICE_DESC	가격 내림차순	✅ Taobao ✅ 1688
SALE_QTY_ASC	판매량 오름차순	✅ Taobao ✅ 1688
SALE_QTY_DESC	판매량 내림차순	✅ Taobao ✅ 1688
RETENTION_ASC	재구매율 오름차순	❌ Taobao ✅ 1688
RETENTION_DESC	재구매율 내림차순	❌ Taobao ✅ 1688

결과 필터 (`filter`)

필터 기준	설명	Platform
price_range	가격 범위 (단위: CNY)	✅ Taobao ✅ 1688
shop_id	같은 판매자의 제품	✅ Taobao ✅ 1688
seller_level	판매자 등급	❌ Taobao ✅ 1688
is_factory	슈퍼 공장 상품만	❌ Taobao ✅ 1688
ffm_outbound	빠른 출고 기준	❌ Taobao ✅ 1688
ffm_delivery	빠른 배송 기준	❌ Taobao ✅ 1688
allow_return	7일 무이유 반품	❌ Taobao ✅ 1688
allow_dropship	드롭쉬핑 허용	❌ Taobao ✅ 1688
freeship_for_dropship	드롭쉬핑 + 무료 배송 허용	❌ Taobao ✅ 1688
new_arrival	플랫폼에 새로 등록된 상품	❌ Taobao ✅ 1688
platform_pick	국내 시장용 플랫폼 선별 소스	❌ Taobao ✅ 1688
global_pick	해외 시장용 플랫폼 선별 소스	❌ Taobao ✅ 1688
dropship_pick	드롭쉬핑용 플랫폼 선별 소스	❌ Taobao ✅ 1688

`ffm_outbound` 값

값	설명
FFMO1	24시간 내 출고율 < 95%
FFMO2	24시간 내 출고율 >= 95%
FFMO3	24시간 내 출고율 > 99%
FFMO4	48시간 내 출고율 < 95%
FFMO5	48시간 내 출고율 >= 95%
FFMO6	48시간 내 출고율 > 99%

`ffm_delivery` 값

값	설명
FFMD0	당일 배송
FFMD1	24시간 내 배송
FFMD2	48시간 내 배송

`new_arrival` 값

값	설명
7DAY	최근 7일 내 새로 등록된 상품
30DAY	최근 30일 내 새로 등록된 상품

`seller_level` 값

값	설명
L1	총 리뷰 점수 5성
L2	총 리뷰 점수 4.5 - 5성
L3	총 리뷰 점수 4 - 4.5성
L4	총 리뷰 점수 4성 미만

이미지로 제품 검색

참고: 이 기능은 무료 요금제에는 적용되지 않습니다.

자세히 보기: 제품 검색

POST /v1/products/search-img

이미지 검색에는 2가지 방법이 있습니다:

1. 이미지 URL로 검색 — 범위: ✅ Taobao ✅ 1688

query 매개변수에서 img_url 키를 사용합니다. Alibaba 링크(*.alicdn.com)만 사용할 수 있습니다.

2. 업로드한 이미지로 검색 — 범위: ✅ Taobao ✅ 1688

이 기능을 사용하려면 먼저 이미지 업로드 API로 Alibaba 서버에 이미지를 업로드합니다. 그런 다음 query 매개변수에서 img_url 대신 img_id 키를 사용합니다.

제품 상세 정보 조회

자세히 보기: 제품 상세

POST /v1/products/find

https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd 형식의 단축 링크를 만나면 먼저 링크를 처리하여 원본 링크를 얻어야 합니다 — 링크 원복 API를 사용하여 원본 링크와 제품 ID를 가져오세요.

제품 가격 유형

가격 속성	설명	Platform
price	일반 가격. 1688은 무료 배송이 포함되지 않은 도매가이며 수량은 판매자 설정에 따름.	✅ Taobao ✅ 1688
promotion_price	프로모션 가격, 일반 가격보다 낮거나 같음.	✅ Taobao ✅ 1688
retail_price	소매가 + 1개부터 무료 배송, 드롭쉬핑용. 주로 1688 선별 제품에 나타남.	❌ Taobao ✅ 1688
dropship_price	1개 소매가, 일반적으로 일반 가격과 같음. 차이는 판매자가 드롭쉬핑을 활성화했는지 여부에 따름.	❌ Taobao ✅ 1688

가격 표시 및 적용 로직

일부 제품에는 여러 가격 유형이 있으며 표시·적용 로직은 플랫폼에 따라 다릅니다. API 가격은 Taobao/1688 웹사이트에서 직접 보는 가격보다 높을 수 있습니다. 웹사이트의 가격 메커니즘이 API가 적용할 수 없는 프로모션이나 할인을 이미 적용했을 수 있기 때문입니다.

경고: 확장 프로그램/웹/앱에서 고객에게 가격을 표시한다면 가격이 Taobao/1688에서 직접 보는 것보다 높을 수 있다는 경고를 추가하세요. API 가격이 더 높게 발견되면 고객 서비스에 연락하여 주문 생성 시 가격 조정 지원을 받으세요.

Taobao: 프로모션 가격을 우선 표시·적용하고, 없으면 일반 가격을 사용합니다.

1688: 가격 적용 로직은 quote_type 필드에 따라 다릅니다:

값	설명
direct	`price` 및 `promotion_price`에 따라 도매가 적용.
by_sku	SKU별 가격 적용.
by_volume	`price_range`에 따라 가격 적용, 최소 구매 수량 `moq`에 따라 다름.

1688 판매자 등급

등급은 seller_type 필드로 확인되는 1688 판매자 신뢰도를 결정하는 데 사용됩니다. 3가지 등급이 있습니다:

값	설명
seller	일반 판매자.
merchant	1688 인증을 받은 전문 판매자.
factory	1688 인증을 받고 1688의 직접 평가 기준을 충족하는 제조 공장.

`extra_info` 필드 설명

값	설명
isOnePsale	드롭쉬핑 지원 여부?
isSupportMix	한 주문에서 여러 제품 구매 가능 여부?
isOnePsaleFreePostage	드롭쉬핑 + 무료 배송 지원 여부?
noReason7DReturn	7일 무이유 반품 허용 여부?
1688_yx	선별 소스인지 여부?

제품 API 참조 v1 (Legacy)

요약

키워드로 제품 검색

언어 번역 (lang)

결과 정렬 (sort)

결과 필터 (filter)

ffm_outbound 값

ffm_delivery 값

new_arrival 값

seller_level 값