Tham chiếu API sản phẩm v1 (Legacy)
⚠️ Legacy: API v1 chỉ còn vận hành song song trong thời gian ngắn. Tích hợp mới nên dùng API Sản phẩm v2.
Tóm tắt
Trang này liệt kê đầy đủ tham số và giá trị của API sản phẩm v1: tìm kiếm theo từ khóa, tìm kiếm bằng ảnh và lấy chi tiết sản phẩm trên Taobao và 1688. Để làm theo từng bước, xem Hướng dẫn tìm kiếm 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
POST /v1/products/search
Dịch ngôn ngữ (lang)
| Giá trị | Mô tả | Platform |
|---|---|---|
| vi | Tiếng Việt | ✅ Taobao ✅ 1688 |
| en | Tiếng Anh | ✅ Taobao ✅ 1688 |
Dữ liệu 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ả (sort)
| Giá trị | Mô tả | Platform |
|---|---|---|
| PRICE_ASC | Giá tăng dần | ✅ Taobao ✅ 1688 |
| PRICE_DESC | Giá giảm 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ả (filter)
| 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 |
Giá trị 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% |
Giá trị ffm_delivery
| Giá trị | Mô tả |
|---|---|
| FFMD0 | Giao trong ngày |
| FFMD1 | Giao trong 24h |
| FFMD2 | Giao trong 48h |
Giá trị 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 |
Giá trị 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
POST /v1/products/search-img
Có 2 cách tìm kiếm bằng ảnh:
1. Tìm kiếm bằng URL ảnh — Phạm vi: ✅ Taobao ✅ 1688
Sử dụng key img_url trong tham số query. Chỉ có thể dùng link ảnh từ Alibaba: *.alicdn.com
2. Tìm kiếm bằng ảnh upload — Phạm vi: ✅ Taobao ✅ 1688
Để dùng chức năng này, trước tiên upload ảnh lên server của Alibaba bằng API Upload image. Sau đó dùng key img_id thay cho img_url trong tham số query.
Lấy thông tin chi tiết sản phẩm
Xem chi tiết: Chi tiết sản phẩm
POST /v1/products/find
Nếu gặp link rút gọn dạng https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd, phải xử lý link trước để lấy link gốc — dùng API Unshorten link để lấy link gốc và ID sản phẩm.
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ó nhiều loại giá, logic hiển thị và áp dụng phụ thuộc vào platform. Giá qua API có thể cao hơn giá xem trực tiếp trên website Taobao/1688 do cơ chế giá trên website có thể đã áp dụng các khuyến mãi, giảm giá mà API không áp dụng được.
Cảnh báo: Nếu bạn hiển thị giá cho khách hàng trên extension/web/app, hãy bổ sung cảnh báo rằng giá có thể cao hơn giá xem trực tiếp trên Taobao/1688. Nếu phát hiện giá trên API cao hơn, liên hệ CSKH để được hỗ trợ điều chỉnh giá khi tạo đơn mua hàng.
Taobao: ưu tiên hiển thị và áp dụng giá khuyến mãi; nếu không có, dùng giá thông thường.
1688: logic áp dụng giá phụ thuộc vào 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 độ dùng để xác định uy tín người bán trên 1688, xác định 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à đáp ứng các tiêu chuẩn đánh giá trực tiếp từ 1688. |
Giải thích 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ó hỗ 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? |
Liên kết liên quan
- Phiên bản hiện tại: API Sản phẩm v2
- Làm theo: Hướng dẫn tìm kiếm sản phẩm
- Công cụ: Elim CLI — tìm kiếm sản phẩm từ terminal
- API Reference đầy đủ: openapi.elim.asia/api