Elimapi

วิธีค้นหาสินค้าบน Taobao/1688

เมื่อใดควรใช้คู่มือนี้

ใช้เมื่อคุณจำเป็นต้องดึงข้อมูลสินค้าจาก Taobao/1688: ค้นหาสินค้าด้วยคีย์เวิร์ดหรือรูปภาพ ใช้ตัวกรอง และดึงรายละเอียดของสินค้าหนึ่งรายการ

คู่มือนี้ใช้ Product API v2 (เวอร์ชันปัจจุบัน) หากคุณใช้ v1 อยู่ ดู Product API v1 (Legacy)

เอกสารอ้างอิงฉบับเต็มของพารามิเตอร์และค่าทั้งหมด: เอกสารอ้างอิง API สินค้า

ข้อกำหนดก่อนเริ่ม

ค้นหาด้วยคีย์เวิร์ด

ขั้นตอนที่ 1 — เรียก endpoint ค้นหา

POST /v2/products/search

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

พารามิเตอร์ platform (taobao หรือ alibaba) เป็น ค่าบังคับ ใน API v2

ขั้นตอนที่ 2 — แปลภาษาผลลัพธ์

ใช้พารามิเตอร์ lang (vi/en/ru/ko/ja) เพื่อรับชื่อสินค้าที่แปลแล้ว ข้อมูลที่แปลแล้วอยู่ใน key title_en; key title ยังคงเป็นภาษาจีนต้นฉบับ

ขั้นตอนที่ 3 — เรียงลำดับผลลัพธ์

ใช้พารามิเตอร์ sort:

ค่าความหมาย
PRICE_ASC / PRICE_DESCราคาเพิ่มขึ้น/ลดลง
SALE_QTY_ASC / SALE_QTY_DESCยอดขายเพิ่มขึ้น/ลดลง

ขั้นตอนที่ 4 — กรองผลลัพธ์ (ไม่บังคับ)

ใช้พารามิเตอร์ filter ตามเกณฑ์ต่อไปนี้ (ส่วนใหญ่ ใช้กับ 1688 เท่านั้น):

  • filter.priceRange — ช่วงราคา (CNY): { "min": 0, "max": 100 } — ✅ Taobao ✅ 1688
  • filter.shopId — สินค้าจากผู้ขายเดียวกัน — ✅ Taobao ✅ 1688
  • filter.sellerLevel (L1–L4) — ระดับผู้ขาย
  • filter.isFactory — เฉพาะสินค้าจากโรงงานซูเปอร์
  • filter.ffmOutbound (FFMO1–FFMO6) — อัตราการจัดส่งออกเร็ว
  • filter.ffmDelivery (FFMD0–FFMD2) — ความเร็วในการจัดส่ง
  • filter.allowDropship, filter.freeshipForDropship — รองรับดรอปชิปปิ้ง
  • filter.newArrival (7DAY/30DAY) — สินค้าใหม่ล่าสุด
  • filter.platformPick, filter.globalPick, filter.dropshipPick — แหล่งสินค้าที่แพลตฟอร์มคัดสรร

รายการค่าตัวกรองทั้งหมด: เอกสารอ้างอิง API สินค้า

ค้นหาด้วยรูปภาพ

หมายเหตุ: ฟังก์ชันนี้ใช้ไม่ได้กับแพ็กเกจ ฟรี

POST /v2/products/search-by-image

มี 2 วิธี:

วิธีที่ 1 — ใช้ URL รูปภาพ (เฉพาะลิงก์ *.alicdn.com):

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

วิธีที่ 2 — ใช้รูปภาพที่อัปโหลดแล้ว:

  1. อัปโหลดรูปภาพผ่าน API POST /v2/products/upload-image เพื่อรับ imageId
  2. เรียก search-by-image ด้วย imgId แทน imgUrl:
{
  "platform": "alibaba",
  "imgId": "image-123",
  "lang": "vi"
}

ดึงรายละเอียดสินค้าหนึ่งรายการ

ขั้นตอนที่ 1 — จัดการลิงก์แบบสั้น (หากมี)

ลิงก์แบบสั้นรูปแบบ https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd ต้องถูกขยายก่อน ใช้ API Unshorten link เพื่อรับลิงก์ต้นฉบับและรหัสสินค้า

ขั้นตอนที่ 2 — เรียก endpoint รายละเอียด

POST /v2/products/find

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

Response ประกอบด้วย: ราคา, สต็อก, ตัวเลือกสินค้า (สี/ไซส์), อัลบั้มรูปภาพ, คำอธิบาย และนโยบายการจัดส่ง หากต้องการข้อมูล 1688 ที่ครบถ้วนกว่า ให้ใช้ POST /v2/products/detail ด้วยโครงสร้างคำขอเดียวกัน

ขั้นตอนที่ 3 — แสดงราคาอย่างถูกต้อง

  • Taobao: ใช้ promotion_price ก่อน; หากไม่มี ให้ใช้ price
  • 1688: ตรรกะราคาขึ้นอยู่กับ quote_type (direct/by_sku/by_volume)

[!WARNING] ราคาจาก API อาจ สูงกว่า ราคาบนเว็บไซต์ Taobao/1688 เนื่องจาก API ไม่สามารถใช้โปรโมชันที่ซับซ้อนได้ ควรเพิ่มคำเตือนให้ลูกค้าทราบหากคุณแสดงราคาบนส่วนขยาย/เว็บ/แอป

ตรวจสอบผลลัพธ์

  • Request คืน HTTP 200 พร้อมอาร์เรย์สินค้าที่มี title, price, img_url
  • ผลการค้นหาด้วยรูปภาพคืนสินค้าที่คล้ายกับรายการในรูปภาพต้นฉบับ

ลิงก์ที่เกี่ยวข้อง