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

ParameterTypesDefaultExample valuesDescription
qStringnull女装 or เสื้อผ้าผู้หญิงคำค้นหา
catString0ID หมวดหมู่
sortStringnullbid, _bid, bid2, _bid2, _sale, _credit*ใต้ตาราง
start_priceInteger010ราคาเริ่มต้น
end_priceInteger0100ราคาสิ้นสุด
pageInteger110หน้า
page_sizeInteger40100จำนวนต่อหน้า
cacheStringyes“yes” or “no”ระบบ Cache
language (ดูภาษาที่รองรับ)Stringzh-CNenแปลภาษาสินค้า

รายละเอียดการ 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 ตามตารางด้านล่าง

nameTypesExample valuesdescription
titleStringFrench retro Yamamoto super fairy chic fairy Hepburn net red early spring very fairy French niche skirt two-piece suitชื่อสินค้า
pic_urlString//img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpgรูปสินค้า
promotion_priceFloat178.00ราคาโปรโมชั่น
priceFloat178.00ราคาสินค้า
salesInt890จำนวนที่ขายแล้ว
num_iidBigint577437133060ID สินค้า
sample_idStringID แบบสินค้า
seller_nickStringChumu flagship storeชื่อร้านค้า
post_feeFloat10.00ค่าส่ง
areaStringShandongที่ตั้งร้าน
detail_urlString//detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0URL สินค้า
seller_infoMix{“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_code": "0000",
	"reason": "ok",
	"secache_time": 1630461276,
	"secache_date": "2021-09-01 09:54:36",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"execution_time": 2.333,
	"server_time": "Beijing/2021-09-01 09:54:36",
	"call_args": {
		"q": "女装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0",
		"page_size": "40"
	},
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"server_memory": "5.44MB"
}
สอบถามได้เลย!