คู่มือ Product API
ต่อไปนี้เป็นคู่มือสำหรับการใช้งาน Product API
ค้นหาสินค้าด้วยคำสำคัญ (Keyword Search)
ดูรายละเอียด: Search products
การแปลภาษา
ใช้พารามิเตอร์ lang เพื่อแปลภาษาของผลการค้นหา ค่าของ lang อธิบายไว้ในตารางด้านล่าง:
| ค่า | คำอธิบาย | แพลตฟอร์ม |
|---|---|---|
| vi | ภาษาเวียดนาม | ✅ Taobao ✅ 1688 |
| en | ภาษาอังกฤษ | ✅ Taobao ✅ 1688 |
| th | ภาษาไทย | ✅ Taobao ✅ 1688 |
ข้อมูลที่ได้รับการแปลจะอยู่ในคีย์ titleEn (สำหรับภาษาอังกฤษและไทยจะถูกใส่ที่นี่) ส่วนคีย์ title จะยังคงเป็นข้อมูลภาษาจีน
การเรียงลำดับผลการค้นหา
ใช้พารามิเตอร์ sort เพื่อเรียงลำดับผลการค้นหา ค่าของ sort อธิบายไว้ในตารางด้านล่าง:
| ค่า | คำอธิบาย | แพลตฟอร์ม |
|---|---|---|
| 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 ในการกรองผลการค้นหา ค่าของ filter อธิบายไว้ในตารางด้านล่าง:
| เกณฑ์การกรอง | คำอธิบาย | แพลตฟอร์ม |
|---|---|---|
| price_range | ช่วงราคา (หน่วย: CNY) | ✅ Taobao ✅ 1688 |
| shop_id | สินค้าจากผู้ขายรายเดียวกัน | ✅ Taobao ✅ 1688 |
| seller_level | ระดับของผู้ขาย | ❌ Taobao ✅ 1688 |
| is_factory | เฉพาะสินค้าจากโรงงานระดับซูเปอร์ (Super Factory) | ❌ Taobao ✅ 1688 |
| ffm_outbound | เกณฑ์การส่งออกจากคลังสินค้าที่รวดเร็ว | ❌ Taobao ✅ 1688 |
| ffm_delivery | เกณฑ์การจัดส่งที่รวดเร็ว | ❌ Taobao ✅ 1688 |
| allow_return | คืนสินค้าได้ภายใน 7 วันโดยไม่มีเหตุผล | ❌ Taobao ✅ 1688 |
| allow_dropship | อนุญาตให้ทำ Dropship | ❌ Taobao ✅ 1688 |
| freeship_for_dropship | อนุญาต Dropship + ส่งฟรี | ❌ Taobao ✅ 1688 |
| new_arrival | สินค้าอัปเดตใหม่บนแพลตฟอร์ม | ❌ Taobao ✅ 1688 |
| platform_pick | แหล่งสินค้าที่แพลตฟอร์มคัดสรรสำหรับตลาดในประเทศ | ❌ Taobao ✅ 1688 |
| global_pick | แหล่งสินค้าที่แพลตฟอร์มคัดสรรสำหรับตลาดต่างประเทศ | ❌ Taobao ✅ 1688 |
| dropship_pick | แหล่งสินค้าที่แพลตฟอร์มคัดสรรสำหรับ Dropship | ❌ 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 ดาว |
ค้นหาสินค้าด้วยรูปภาพ (Search by Image)
หมายเหตุ: ฟีเจอร์นี้ไม่สามารถใช้งานได้ในแพ็กเกจ ฟรี (Free)
ดูรายละเอียด: Search products
มี 2 วิธีในการค้นหาสินค้าด้วยรูปภาพ:
1. ค้นหาด้วย URL ของรูปภาพ
ขอบเขตการใช้งาน: ✅ Taobao ✅ 1688
ใช้คีย์ img_url ในพารามิเตอร์สำหรับการสืบค้น อย่างไรก็ตาม สามารถใช้ได้เฉพาะลิงก์รูปภาพจาก Alibaba เท่านั้น: *.alicdn.com
2. ค้นหาด้วยรูปภาพที่อัปโหลด
ขอบเขตการใช้งาน: ✅ Taobao ✅ 1688
หากต้องการใช้ฟังก์ชันนี้ ให้ทำการอัปโหลดรูปภาพไปยังเซิร์ฟเวอร์ของ Alibaba ก่อนโดยใช้ API Upload image จากนั้นใช้คีย์ img_id แทน img_url ในพารามิเตอร์การสืบค้นเพื่อส่งคำขอ
รับข้อมูลรายละเอียดสินค้า
ดูรายละเอียด: Product details
หากคุณพบบ่อยๆ ว่าลิงก์สั้นอย่างเช่น https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd คุณต้องประมวลผลลิงก์นี้ก่อนเพื่อให้ได้ลิงก์ต้นฉบับ
ใช้ API Unshorten link เพื่อรับลิงก์ต้นฉบับและรหัสสินค้า (Product ID)
คำอธิบายประเภทราคาสินค้า
| แอตทริบิวต์ราคา | คำอธิบาย | แแพลตฟอร์ม |
|---|---|---|
| price | ราคาปกติ สำหรับ 1688 จะเป็นราคาส่งที่ไม่รวมค่าส่ง จำนวนขึ้นอยู่กับการตั้งค่าของผู้ขาย | ✅ Taobao ✅ 1688 |
| promotion_price | ราคาโปรโมชัน ซึ่งจะต่ำกว่าหรือเท่ากับราคาปกติ | ✅ Taobao ✅ 1688 |
| retail_price | ราคาขายปลีก + ส่งฟรีตั้งแต่ 1 ชิ้น สำหรับ Dropshipping มักพบในสินค้า 1688 ที่ได้รับเลือก | ❌ Taobao ✅ 1688 |
| dropship_price | ราคาขายปลีกสำหรับ 1 ชิ้น มักจะเท่ากับราคาปกติ ความแตกต่างขึ้นอยู่กับว่าผู้ขายเปิดใช้งาน Dropship หรือไม่ | ❌ 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 | รองรับ Dropshipping หรือไม่? |
| isSupportMix | อนุญาตให้ซื้อสินค้าหลายรายการในหนึ่งคำสั่งซื้อหรือไม่? |
| isOnePsaleFreePostage | รองรับ Dropshipping + ส่งฟรีหรือไม่? |
| noReason7DReturn | อนุญาตคืนสินค้าโดยไม่มีเหตุผลภายใน 7 วันหรือไม่? |
| 1688_yx | เป็นแหล่งสินค้าที่ได้รับการคัดเลือกหรือไม่? |