เอกสารอ้างอิง API สินค้า v1 (Legacy)
⚠️ Legacy: API v1 จะทำงานคู่ขนานต่อไปในระยะเวลาสั้นๆ เท่านั้น การผสานรวมใหม่ควรใช้ API สินค้า v2
สรุป
หน้านี้ระบุพารามิเตอร์และค่าทั้งหมดของ API สินค้า v1: ค้นหาด้วยคำสำคัญ ค้นหาด้วยรูปภาพ และดึงรายละเอียดสินค้าบน Taobao และ 1688 หากต้องการทำตามทีละขั้นตอน ดู คู่มือการค้นหาสินค้า
ค้นหาสินค้าด้วยคำสำคัญ
ดูรายละเอียด: ค้นหาสินค้า
POST /v1/products/search
การแปลภาษา (lang)
| ค่า | คำอธิบาย | Platform |
|---|---|---|
| vi | ภาษาเวียดนาม | ✅ Taobao ✅ 1688 |
| en | ภาษาอังกฤษ | ✅ Taobao ✅ 1688 |
ข้อมูลที่แปลอยู่ใน key titleEn key title ยังเป็นข้อมูลภาษาจีน
เรียงลำดับผลลัพธ์ (sort)
| ค่า | คำอธิบาย | Platform |
|---|---|---|
| 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)
| เกณฑ์กรอง | คำอธิบาย | Platform |
|---|---|---|
| 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 ดาว |
ค้นหาสินค้าด้วยรูปภาพ
หมายเหตุ: ฟังก์ชันนี้ไม่ใช้กับแพ็กเกจ ฟรี
ดูรายละเอียด: ค้นหาสินค้า
POST /v1/products/search-img
มี 2 วิธีค้นหาด้วยรูปภาพ:
1. ค้นหาด้วย URL รูปภาพ — ขอบเขต: ✅ Taobao ✅ 1688
ใช้ key img_url ในพารามิเตอร์ query ใช้ได้เฉพาะลิงก์รูปภาพจาก Alibaba: *.alicdn.com
2. ค้นหาด้วยรูปภาพที่อัปโหลด — ขอบเขต: ✅ Taobao ✅ 1688
หากต้องการใช้ฟังก์ชันนี้ ก่อนอื่นอัปโหลดรูปภาพไปยังเซิร์ฟเวอร์ของ Alibaba ผ่าน API อัปโหลดรูปภาพ จากนั้นใช้ key img_id แทน img_url ในพารามิเตอร์ query
ดึงข้อมูลรายละเอียดสินค้า
ดูรายละเอียด: รายละเอียดสินค้า
POST /v1/products/find
หากเจอลิงก์ย่อรูปแบบ https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd ต้องแปลงลิงก์ก่อนเพื่อให้ได้ลิงก์ต้นฉบับ — ใช้ API Unshorten link เพื่อรับลิงก์ต้นฉบับและ ID สินค้า
ประเภทราคาสินค้า
| ฟิลด์ราคา | คำอธิบาย | Platform |
|---|---|---|
| price | ราคาปกติ สำหรับ 1688 คือราคาส่งแบบไม่ฟรีค่าจัดส่ง จำนวนขึ้นอยู่กับการตั้งค่าของผู้ขาย | ✅ Taobao ✅ 1688 |
| promotion_price | ราคาโปรโมชัน ต่ำกว่าหรือเท่ากับราคาปกติ | ✅ Taobao ✅ 1688 |
| retail_price | ราคาขายปลีก + ค่าจัดส่งฟรีตั้งแต่ 1 ชิ้น สำหรับดรอปชิปปิ้ง มักปรากฏในสินค้า 1688 ที่คัดเลือก | ❌ Taobao ✅ 1688 |
| dropship_price | ราคาขายปลีกต่อชิ้น มักเท่ากับราคาปกติ ต่างกันตรงที่ขึ้นอยู่กับว่าผู้ขายเปิดใช้ดรอปชิปหรือไม่ | ❌ Taobao ✅ 1688 |
ตรรกะการแสดงและการใช้ราคา
สินค้าบางรายการมีราคาหลายแบบ ตรรกะการแสดงและการใช้ขึ้นอยู่กับแพลตฟอร์ม ราคาจาก API อาจสูงกว่าราคาที่เห็นโดยตรงบนเว็บไซต์ 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 | เป็นแหล่งสินค้าที่คัดเลือกหรือไม่? |
ลิงก์ที่เกี่ยวข้อง
- เวอร์ชันปัจจุบัน: API สินค้า v2
- ปฏิบัติตาม: คู่มือการค้นหาสินค้า
- เครื่องมือ: Elim CLI — ค้นหาสินค้าจากเทอร์มินัล
- เอกสารอ้างอิง API ฉบับเต็ม: openapi.elim.asia/api