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"
	}
}