Elimapi

Cách tìm kiếm sản phẩm trên Taobao/1688

Khi nào dùng hướng dẫn này

Dùng khi bạn cần lấy dữ liệu sản phẩm từ Taobao/1688: tìm sản phẩm theo từ khóa hoặc hình ảnh, áp dụng bộ lọc, và lấy chi tiết một sản phẩm.

Hướng dẫn này dùng API Sản phẩm v2 (phiên bản hiện tại). Nếu bạn đang dùng v1, xem API Sản phẩm v1 (Legacy).

Tham chiếu đầy đủ mọi tham số và giá trị: Tham chiếu API sản phẩm

Điều kiện trước

Tìm kiếm theo từ khóa

Bước 1 — Gọi endpoint tìm kiếm

POST /v2/products/search

{
  "platform": "taobao",
  "q": "áo thun cotton",
  "page": 1,
  "size": 20,
  "lang": "vi"
}

Tham số platform (taobao hoặc alibaba) là bắt buộc trong API v2.

Bước 2 — Dịch ngôn ngữ kết quả

Dùng tham số lang (vi/en/ru/ko/ja) để nhận tiêu đề đã dịch. Dữ liệu dịch nằm trong key title_en; key title vẫn là tiếng Trung gốc.

Bước 3 — Sắp xếp kết quả

Dùng tham số sort:

Giá trịÝ nghĩa
PRICE_ASC / PRICE_DESCGiá tăng/giảm dần
SALE_QTY_ASC / SALE_QTY_DESCLượt bán tăng/giảm dần

Bước 4 — Lọc kết quả (tuỳ chọn)

Dùng tham số filter với các tiêu chí sau (đa số chỉ áp dụng cho 1688):

  • filter.priceRange — khoảng giá (CNY): { "min": 0, "max": 100 } — ✅ Taobao ✅ 1688
  • filter.shopId — sản phẩm cùng người bán — ✅ Taobao ✅ 1688
  • filter.sellerLevel (L1–L4) — cấp độ người bán
  • filter.isFactory — chỉ lấy hàng siêu nhà máy
  • filter.ffmOutbound (FFMO1–FFMO6) — tỷ lệ xuất hàng nhanh
  • filter.ffmDelivery (FFMD0–FFMD2) — tốc độ giao hàng
  • filter.allowDropship, filter.freeshipForDropship — hỗ trợ dropship
  • filter.newArrival (7DAY/30DAY) — hàng mới cập nhật
  • filter.platformPick, filter.globalPick, filter.dropshipPick — nguồn hàng sàn tuyển

Danh sách đầy đủ giá trị từng bộ lọc: Tham chiếu API sản phẩm

Tìm kiếm bằng hình ảnh

Lưu ý: Tính năng này không áp dụng với gói Miễn phí.

POST /v2/products/search-by-image

Có 2 cách:

Cách 1 — Dùng URL ảnh (chỉ link *.alicdn.com):

{
  "platform": "taobao",
  "imgUrl": "https://img.alicdn.com/bao/uploaded/i3/694223667/O1CN01zSjKgp1cxXRQZsDLA_!!694223667.jpg",
  "lang": "vi"
}

Cách 2 — Dùng ảnh đã upload:

  1. Upload ảnh qua API POST /v2/products/upload-image để lấy imageId.
  2. Gọi search-by-image với imgId thay cho imgUrl:
{
  "platform": "alibaba",
  "imgId": "image-123",
  "lang": "vi"
}

Lấy chi tiết một sản phẩm

Bước 1 — Xử lý link rút gọn (nếu có)

Link rút gọn dạng https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd phải được mở rộng trước. Dùng API Unshorten link để lấy link gốc và ID sản phẩm.

Bước 2 — Gọi endpoint chi tiết

POST /v2/products/find

{
  "platform": "taobao",
  "id": "734467086498"
}

Response gồm: giá, tồn kho, biến thể (màu/size), album ảnh, mô tả và chính sách vận chuyển. Nếu cần dữ liệu 1688 đầy đủ hơn, dùng POST /v2/products/detail với cùng cấu trúc request.

Bước 3 — Hiển thị giá đúng cách

  • Taobao: ưu tiên promotion_price; nếu không có, dùng price.
  • 1688: logic giá phụ thuộc quote_type (direct/by_sku/by_volume).

[!WARNING] Giá từ API có thể cao hơn giá trên website Taobao/1688 vì API không áp dụng được khuyến mãi phức tạp. Bổ sung cảnh báo cho khách hàng nếu bạn hiển thị giá trên extension/web/app.

Xác minh kết quả

  • Request trả về HTTP 200 với mảng sản phẩm chứa title, price, img_url.
  • Kết quả tìm kiếm bằng ảnh trả về các sản phẩm tương tự mặt hàng trong ảnh gốc.

Liên kết liên quan