제품 API 가이드
다음은 제품 API 가이드입니다
키워드로 제품 검색
세부 정보 보기: 제품 검색
언어 번역
lang 매개변수를 사용하여 검색 결과의 언어를 번역합니다. lang 값은 아래 표에 설명되어 있습니다:
| 값 | 설명 | 플랫폼 |
|---|---|---|
| vi | 베트남어 | ✅ Taobao ✅ 1688 |
| en | 영어 | ✅ Taobao ✅ 1688 |
번역된 데이터는 titleEn 키에 있습니다. title 키는 여전히 중국어 데이터입니다.
검색 결과 정렬
sort 매개변수를 사용하여 검색 결과를 정렬합니다. sort 값은 아래 표에 설명되어 있습니다:
| 값 | 설명 | 플랫폼 |
|---|---|---|
| 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 매개변수를 사용하여 검색 결과를 정렬합니다. filter 값은 아래 표에 설명되어 있습니다:
| 필터 기준 | 설명 | 플랫폼 |
|---|---|---|
| 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성 미만 |
이미지로 제품 검색
참고: 이 기능은 무료 플랜에는 적용되지 않습니다.
세부 정보 보기: 제품 검색
이미지로 제품을 검색하는 방법은 2가지가 있습니다:
1. 이미지 URL로 검색
적용 범위: ✅ Taobao ✅ 1688
매개변수에서 img_url 키를 사용하여 쿼리합니다. 그러나 Alibaba의 이미지 링크만 사용할 수 있습니다: *.alicdn.com
2. 업로드한 이미지로 검색
적용 범위: ✅ Taobao ✅ 1688
이 기능을 사용하려면 먼저 API 이미지 업로드를 사용하여 이미지를 Alibaba 서버에 업로드해야 합니다. 그런 다음 쿼리 매개변수에서 img_id 키를 img_url 대신 사용하여 요청을 실행합니다.
제품 상세 정보 가져오기
세부 정보 보기: 제품 상세
https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd와 같은 짧은 링크를 자주 접하는 경우 원본 링크를 얻기 위해 먼저 이 링크를 처리해야 합니다.
API 링크 복구를 사용하여 원본 링크와 제품 ID를 가져옵니다.
제품 가격 유형 설명
| 가격 속성 | 설명 | 플랫폼 |
|---|---|---|
| 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의 경우 가격 적용 로직은 quote_type 필드 값에 따라 다릅니다:
| 값 | 설명 |
|---|---|
| direct | price 및 promotion_price로 도매 가격 가져오기. |
| by_sku | SKU별로 가격 가져오기. |
| by_volume | price_range로 가격 가져오기, 최소 주문 수량 moq에 따라 다름. |
1688의 판매자 수준
이 수준은 1688에서 판매자의 신뢰성을 결정하는 데도 사용되며, seller_type 필드를 통해 결정됩니다. 3개 수준이 있습니다:
| 값 | 설명 |
|---|---|
| seller | 일반 판매자. |
| merchant | 전문 판매자, 1688에서 인증됨. |
| factory | 제조 공장, 1688에서 인증되었으며 1688 직접 평가 표준을 충족함. |
extra_info의 필드 값 설명
| 값 | 설명 |
|---|---|
| isOnePsale | 드롭십을 지원합니까? |
| isSupportMix | 하나의 주문에서 여러 제품 구매를 허용합니까? |
| isOnePsaleFreePostage | 드롭십 + 무료배송을 지원합니까? |
| noReason7DReturn | 7일 이내 무료 반품을 허용합니까? |
| 1688_yx | 선정 공급원입니까? |