API: item-search ค้นหาสินค้าด้วย Keyword
API สำหรับค้าหาสินค้าจากเว็บไซต์ Taobao หรือ Tmall ด้วย Keyword หากไม่ได้เปิดใช้งานระบบคำค้นหาด้วยภาษาไทย parameter “q” ต้องระบุด้วยภาษาจีนเท่านั้น
HTTP Request
POST: {domain}/api/v3/taobao/item-search
Request body
ก่อน Request ต้อง Set header ตามคู่มือเริ่มใช้งานก่อน ดูรายละเอียด Header Request parameter
Parameter | Types | Default | Example values | Description |
---|---|---|---|---|
q | String | null | 女装 or เสื้อผ้าผู้หญิง | คำค้นหา |
cat | String | 0 | ID หมวดหมู่ | |
sort | String | null | bid, _bid, bid2, _bid2, _sale, _credit | *ใต้ตาราง |
start_price | Integer | 0 | 10 | ราคาเริ่มต้น |
end_price | Integer | 0 | 100 | ราคาสิ้นสุด |
page | Integer | 1 | 10 | หน้า |
page_size | Integer | 40 | 100 | จำนวนต่อหน้า |
cache | String | yes | “yes” or “no” | ระบบ Cache |
language (ดูภาษาที่รองรับ) | String | zh-CN | en | แปลภาษาสินค้า |
รายละเอียดการ sort
- bid คือ เรียงจาก “total price” น้อย-มาก
- _bid คือ เรียงจาก “total price” มาก-น้อย
- bid2 คือ เรียงจาก “product price” น้อย-มาก
- _bid2 คือ เรียงจาก “product price” มาก-น้อย
- sale คือ เรียงจาก “จำนวนการขาย” น้อย-มาก
- _sale คือ เรียงจาก “จำนวนการขาย” มาก-น้อย
- credit คือ เรียงจาก “เครดิต” น้อย-มาก
- _credit คือ เรียงจาก “เครดิต” มาก-น้อย
รายละเอียด start_price และ end_price
เนื่องจากราคาสินค้าจะมีหลายราคา ทั้ง total price, price, original price, promotion price ซึ่งระบบจะ filter จาก promotion price เท่านั้นเนื่องจากเป็นราคาที่ขายจริงบนเว็บไซต์
Response
Return status 200 พร้อม Response ตามตารางด้านล่าง
name | Types | Example values | description |
---|---|---|---|
title | String | French retro Yamamoto super fairy chic fairy Hepburn net red early spring very fairy French niche skirt two-piece suit | ชื่อสินค้า |
pic_url | String | //img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg | รูปสินค้า |
promotion_price | Float | 178.00 | ราคาโปรโมชั่น |
price | Float | 178.00 | ราคาสินค้า |
sales | Int | 890 | จำนวนที่ขายแล้ว |
num_iid | Bigint | 577437133060 | ID สินค้า |
sample_id | String | ID แบบสินค้า | |
seller_nick | String | Chumu flagship store | ชื่อร้านค้า |
post_fee | Float | 10.00 | ค่าส่ง |
area | String | Shandong | ที่ตั้งร้าน |
detail_url | String | //detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0 | URL สินค้า |
seller_info | Mix | {“level”: 99, “shop_type”: “B”, “user_num_id”: “2217148345”, “cid”: 0, “delivery_score”: “”, “item_score”: “”, “score_p”: “”} | ข้อมูลร้านค้า |
{
"items": {
"page": "1",
"page_no": "1",
"real_total_results": "1204093",
"total_results": "1204093",
"page_size": "10",
"pagecount": "100",
"item": [
{
"title": "南极人吊带背心女士夏季薄款无痕外穿上衣莫代尔内搭打底衫内衣服",
"pic_url": "https://img.alicdn.com/bao/uploaded/i2/921087833/O1CN0146QYtE27jYuiivmiE_!!0-item_pic.jpg",
"promotion_price": "49.9",
"price": "49.9",
"sales": 100,
"num_iid": "595294400309",
"seller_nick": "南极人乐客专卖店",
"area": "山东 烟台",
"seller_id": "921087833",
"detail_url": "https://detail.tmall.com/item.htm?id=595294400309&skuId=4657775150844&spm=a1z60.7754815.item.0"
},
{
"title": "吊带背心女夏季性感外穿字母印花打底上衣百搭显瘦黑白色内搭无袖",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3921451270/O1CN01y2TBiD1LFhbOQiEaB_!!0-item_pic.jpg",
"promotion_price": "5.9",
"price": "5.9",
"sales": 5,
"num_iid": "617662062912",
"seller_nick": "运绯旗舰店",
"area": "广东 广州",
"seller_id": "3921451270",
"detail_url": "https://detail.tmall.com/item.htm?id=617662062912&skuId=4354196316126&spm=a1z60.7754815.item.1"
},
{
"title": "抹胸内衣女无钢圈美背吊带网红爆款运动文胸学生高中少女裹胸背心",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3921451270/O1CN01zsFaqY1LFhazWBohf_!!3921451270-0-lubanu-s.jpg",
"promotion_price": "12.9",
"price": "12.9",
"sales": 1,
"num_iid": "615366578050",
"seller_nick": "运绯旗舰店",
"area": "广东 广州",
"seller_id": "3921451270",
"detail_url": "https://detail.tmall.com/item.htm?id=615366578050&skuId=0&spm=a1z60.7754815.item.2"
},
{
"title": "白色针织小吊带背心女春秋西装内搭外穿设计感小众打底衫抹胸上衣",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3490220968/O1CN019VNgMI1J1O2tRV6vd_!!0-item_pic.jpg",
"promotion_price": "29.0",
"price": "29.0",
"sales": 67,
"num_iid": "636009864040",
"seller_nick": "zenpp旗舰店",
"area": "广东 广州",
"seller_id": "3490220968",
"detail_url": "https://detail.tmall.com/item.htm?id=636009864040&skuId=4564331465812&spm=a1z60.7754815.item.3"
},
{
"title": "加棉加厚外套女春秋2021年新款秋冬保暖休闲棒球服夹克薄款上衣冬",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2056219299/O1CN01f4eOt62IYzd2DvUnR_!!2056219299-0-lubanu-s.jpg",
"promotion_price": "79.0",
"price": "79.0",
"sales": 55,
"num_iid": "610995703539",
"seller_nick": "韩贝娇旗舰店",
"area": "福建 泉州",
"seller_id": "2056219299",
"detail_url": "https://detail.tmall.com/item.htm?id=610995703539&skuId=4298210276201&spm=a1z60.7754815.item.4"
},
{
"title": "冰丝吊带背心女夏季内搭无袖t恤针织打底衫外穿潮小上衣搭短款",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3009170952/O1CN01NPPHHF1Iu3eIa8MhB_!!0-item_pic.jpg",
"promotion_price": "59.0",
"price": "59.0",
"sales": 85,
"num_iid": "616002481449",
"seller_nick": "翠朵旗舰店",
"area": "广东 东莞",
"seller_id": "3009170952",
"detail_url": "https://detail.tmall.com/item.htm?id=616002481449&skuId=4512239206919&spm=a1z60.7754815.item.5"
},
{
"title": "莫代尔小吊带背心女短款春夏季黑白色修身打底衫上衣外穿内搭性感",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3103121844/TB1ZNUzmmYH8KJjSspdXXcRgVXa_!!0-item_pic.jpg",
"promotion_price": "7.8",
"price": "7.8",
"sales": 7000,
"num_iid": "563940313464",
"seller_nick": "鑫红蓝旗舰店",
"area": "山东 青岛",
"seller_id": "3103121844",
"detail_url": "https://detail.tmall.com/item.htm?id=563940313464&skuId=4867217871715&spm=a1z60.7754815.item.6"
},
{
"title": "网红同款韩版加绒保暖蕾丝美背打底抹胸内搭修身吊带外穿背心女潮",
"pic_url": "https://img.alicdn.com/bao/uploaded/i4/3921451270/O1CN01X7mtRc1LFhbaAFsQe_!!3921451270-0-lubanu-s.jpg",
"promotion_price": "13.9",
"price": "13.9",
"sales": 100,
"num_iid": "618679101574",
"seller_nick": "运绯旗舰店",
"area": "广东 广州",
"seller_id": "3921451270",
"detail_url": "https://detail.tmall.com/item.htm?id=618679101574&skuId=4541661535548&spm=a1z60.7754815.item.7"
},
{
"title": "吊带背心女外穿夏季短款薄百搭打底显瘦黑白色上衣吊带衫内搭性感",
"pic_url": "https://img.alicdn.com/bao/uploaded/i2/2011877378/O1CN010KF0ax24NAldq3Gkz_!!2011877378-0-lubanu-s.jpg",
"promotion_price": "3.9",
"price": "3.9",
"sales": 10,
"num_iid": "615774224878",
"seller_nick": "hanchao韩巢旗舰店",
"area": "浙江 金华",
"seller_id": "2011877378",
"detail_url": "https://detail.tmall.com/item.htm?id=615774224878&skuId=4512688170567&spm=a1z60.7754815.item.8"
},
{
"title": "蕾丝文胸美背内衣女无钢圈裹胸女抹胸背心式性感聚拢胸罩网红爆款",
"pic_url": "https://img.alicdn.com/bao/uploaded/i4/3921451270/O1CN01mpDExu1LFhbEisBCb_!!3921451270-0-lubanu-s.jpg",
"promotion_price": "12.9",
"price": "12.9",
"sales": 0,
"num_iid": "617060606182",
"seller_nick": "运绯旗舰店",
"area": "广东 广州",
"seller_id": "3921451270",
"detail_url": "https://detail.tmall.com/item.htm?id=617060606182&skuId=4523655343740&spm=a1z60.7754815.item.9"
}
],
"data_from": "tianmiao",
"item_weight_update": 0
},
"error": "",
"cache": 0,
"call_args": {
"q": "女装",
"start_price": "0",
"end_price": "0",
"page": "1",
"cat": "0",
"page_size": "40"
}
}