Hướng dẫn API sản phẩm
Sau đây là hướng dẫn về API sản phẩm
Tìm kiếm sản phẩm bằng từ khóa
Xem chi tiết: Tìm sản phẩm
Dịch ngôn ngữ
Sử dụng tham số lang để dịch ngôn ngữ của kết quả tìm kiếm. Giá trị của lang được mô tả như bảng dưới đây:
| Giá trị | Mô tả | Platform |
|---|---|---|
| vi | Tiếng Việt | ✅ Taobao ✅ 1688 |
| en | Tiếng Anh | ✅ Taobao ✅ 1688 |
Dữ liệu được dịch nằm trong key titleEn. Key title vẫn là dữ liệu tiếng Trung.
Sắp xếp kết quả tìm kiếm
Sử dụng tham số sort để sắp xếp kết quả tìm kiếm. Giá trị của sort được mô tả như bảng dưới đây:
| Giá trị | Mô tả | Platform |
|---|---|---|
| PRICE_ASC | Giá giảm dần | ✅ Taobao ✅ 1688 |
| PRICE_DESC | Giá tăng dần | ✅ Taobao ✅ 1688 |
| SALE_QTY_ASC | Lượt bán tăng dần | ✅ Taobao ✅ 1688 |
| SALE_QTY_DESC | Lượt bán giảm dần | ✅ Taobao ✅ 1688 |
| RETENTION_ASC | Tỷ lệ mua lại tăng dần | ❌ Taobao ✅ 1688 |
| RETENTION_DESC | Tỷ lệ mua lại giảm dần | ❌ Taobao ✅ 1688 |
Lọc kết quả tìm kiếm
Sử dụng tham số filter để sắp xếp kết quả tìm kiếm. Giá trị của filter được mô tả như bảng dưới đây:
| Tiêu chí lọc | Mô tả | Platform |
|---|---|---|
| price_range | Khoảng giá (đơn vị: CNY) | ✅ Taobao ✅ 1688 |
| shop_id | Sản phẩm cùng người bán | ✅ Taobao ❌ 1688 |
| seller_level | Cấp độ người bán | ❌ Taobao ✅ 1688 |
| is_factory | Chỉ lấy hàng từ siêu nhà máy | ❌ Taobao ✅ 1688 |
| ffm_outbound | Tiêu chí xuất hàng nhanh | ❌ Taobao ✅ 1688 |
| ffm_delivery | Tiêu chí giao hàng nhanh | ❌ Taobao ✅ 1688 |
| allow_return | 7 ngày hoàn không lý do | ❌ Taobao ✅ 1688 |
| allow_dropship | Cho phép dropship | ❌ Taobao ✅ 1688 |
| freeship_for_dropship | Cho phép dropship + freeship | ❌ Taobao ✅ 1688 |
| new_arrival | Hàng mới cập nhật lên sàn | ❌ Taobao ✅ 1688 |
| platform_pick | Nguồn hàng sàn tuyển cho nội địa | ❌ Taobao ✅ 1688 |
| global_pick | Nguồn hàng sàn tuyển cho thị trường QT | ❌ Taobao ✅ 1688 |
| dropship_pick | Nguồn hàng sàn tuyển cho dropship | ❌ Taobao ✅ 1688 |
Tiêu chí xuất hàng nhanh ffm_outbound
| Giá trị | Mô tả |
|---|---|
| FFMO1 | Tỷ lệ xuất hàng trong 24h < 95% |
| FFMO2 | Tỷ lệ xuất hàng trong 24h >= 95% |
| FFMO3 | Tỷ lệ xuất hàng trong 24h > 99% |
| FFMO4 | Tỷ lệ xuất hàng trong 48h < 95% |
| FFMO5 | Tỷ lệ xuất hàng trong 48h >= 95% |
| FFMO6 | Tỷ lệ xuất hàng trong 48h > 99% |
Tiêu chí giao hàng nhanh ffm_delivery
| Giá trị | Mô tả |
|---|---|
| FFMD0 | Giao trong ngày |
| FFMD1 | Giao trong 24h |
| FFMD2 | Giao trong 48h |
Tiêu chí giao hàng nhanh new_arrival
| Giá trị | Mô tả |
|---|---|
| 7DAY | Hàng mới cập nhật trong 7 ngày gần nhất |
| 30DAY | Hàng mới cập nhật trong 30 ngày gần nhất |
Tiêu chí cấp độ người bán seller_level
| Giá trị | Mô tả |
|---|---|
| L1 | Tổng điểm đánh giá 5 sao |
| L2 | Tổng điểm đánh giá 4.5 -5 sao |
| L3 | Tổng điểm đánh giá 4 - 4.5 sao |
| L4 | Tổng điểm đánh giá dưới 4 sao |
Tìm kiếm sản phẩm bằng ảnh
Lưu ý: Tính năng này không áp dụng với gói Miễn phí.
Xem chi tiết: Tìm sản phẩm
Có 2 cách để tìm kiếm sản phẩm bằng ảnh:
1. Tìm kiếm bằng URL ảnh
Phạm vi áp dụng: ✅ Taobao ✅ 1688
Sử dụng key img_url trong tham số để query. Tuy nhiên chỉ có thể sử link ảnh từ Alibaba: *.alicdn.com
2. Tìm kiếm bằng ảnh upload
Phạm vi áp dụng: ✅ Taobao ❌ 1688
Để sử dụng chức này thì trước tiên phải upload ảnh lên server của Alibaba sử dụng API Upload image. Sau đó dùng key img_id thay cho img_url trong tham số query để thực hiện request.
Lấy thông tin chi tiết của sản phẩm
Xem chi tiết: Chi tiết sản phẩm
Nếu bạn hay gặp phải link rút gọn dạng https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd thì phải cần phải xử lý link này trước để lấy được link gốc.
Sử dụng API Unshorten link để lấy link gốc và ID sản phẩm.
Giải thích các loại giá sản phẩm
| Thuộc tính giá | Mô tả | Platform |
|---|---|---|
| price | Giá thông thường. Đối với 1688 là giá sỉ không freeship, số lượng tùy thuộc seller cài đặt. | ✅ Taobao ✅ 1688 |
| promotion_price | Giá khuyến mãi, thấp hơn hoặc bằng giá thông thường. | ✅ Taobao ✅ 1688 |
| retail_price | Giá bán lẻ + freeship từ 1 sản phẩm, dành cho dropshipping. Thường xuất hiện ở các sản phẩm 1688 tuyển chọn. | ❌ Taobao ✅ 1688 |
| dropship_price | Giá bán lẻ 1 cái, thường bằng giá thông thường. Khác biệt là phụ thuộc seller có active dropship hay không. | ❌ Taobao ✅ 1688 |
Logic hiển thị và áp dụng giá
Một số sản phẩm có thể có nhiều loại giá, logic hiển thị và áp dụng giá phụ thuộc vào platform. Ngoài ra, giá qua API có thể cao hơn giá xem trực tiếp trên website taobao/1688. Điều này là do cơ chế giá trên website có thể đã được áp dụng các khuyến mãi, giảm giá, hoặc các chương trình khuyến mãi khác. Mà giá trên API không thể áp dụng các chương trình khuyến mãi phức tạp này.
Đối với taobao, ưu tiên hiển thị và áp dụng giá khuyến mãi. Nếu không có giá khuyến mãi, sử dụng giá thông thường.
Đối với 1688, logic áp dụng giá phụ thuộc vào giá trị của trường quote_type:
| Giá trị | Mô tả |
|---|---|
| direct | Lấy giá sỉ theo price và promotion_price. |
| by_sku | Lấy giá theo từng SKU. |
| by_volume | Lấy giá theo price_range và phụ thuộc vào số lượng mua tối thiểu moq. |
Các cấp độ người bán trên 1688
Cấp độ hay còn dùng để xác định uy tín của người bán trên 1688 xác định thông qua trường seller_type. Có 3 cấp độ:
| Giá trị | Mô tả |
|---|---|
| seller | Nhà bán hàng phổ thông. |
| merchant | Nhà bán hàng chuyên nghiệp, đã được 1688 xác thực. |
| factory | Nhà máy sản xuất, đã được 1688 xác thực và đảm yêu các tiêu chuẩn đánh giá trực tiếp từ 1688. |
Giải thích giá trị các trường trong extra_info
| Giá trị | Mô tả |
|---|---|
| isOnePsale | Có hỗ trợ dropshipping hay không? |
| isSupportMix | Có cho mua nhiều sản phẩm trong 1 đơn hàng hay không? |
| isOnePsaleFreePostage | Có jỗ trợ dropshipping + freeship hay không? |
| noReason7DReturn | Có cho phép hoàn hàng không lý do trong 7 ngày hay không? |
| 1688_yx | Có phải nguồn hàng tuyển chọn hay không? |