API: item-search ค้นหาสินค้าด้วย Keyword

API สำหรับค้าหาสินค้าจากเว็บไซต์ 1688 ด้วย Keyword หากไม่ได้เปิดใช้งานระบบคำค้นหาด้วยภาษาไทย parameter “q” ต้องระบุด้วยภาษาจีนเท่านั้น

HTTP Request

POST: {domain}/api/v3/1688/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, _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” มาก-น้อย
• 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
page	String	1	หน้า
real_total_results	Int	1900	จำนวนสินค้า
total_results	Int	1900	จำนวนสินค้า
page_size	Int	19	จำนวนหน้า
pagecount	Int	100	จำนวนต่อหน้า
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 สินค้า
tag_percent	String	31.4%	เปอรเซ็นสินค้า
post_fee	Float	10.00	ค่าส่ง
area	String	Shandong	ที่ตั้งร้าน
detail_url	String	//detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0	URL สินค้า

{
	"items": {
		"page": "1",
		"real_total_results": 1900,
		"total_results": 1900,
		"page_size": 19,
		"pagecount": 100,
		"item": [
			{
				"title": "2021新品春秋季新品气质通勤简约时尚长款打底针织衫连衣裙",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZWo1LD1gD3IbADIe5_!!1792724107-0-cib.jpg",
				"promotion_price": "119.00",
				"price": "119.00",
				"sales": 4000,
				"num_iid": "638022681055",
				"seller_nick": "嘉兴柳斯舍服饰有限公司",
				"tag_percent": "53.6%",
				"area": "桐乡市",
				"detail_url": "https://detail.1688.com/offer/638022681055.html"
			},
			{
				"title": "女装2021新款春季秋装茶歇裙子法式大码显瘦小个子早秋气质连衣裙",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lgGU9021WNzTZvKv5_!!2207001166992-0-cib.jpg",
				"promotion_price": "75.00",
				"price": "75.00",
				"sales": 430000,
				"num_iid": "639275543737",
				"seller_nick": "广州歌诗娅服装厂",
				"tag_percent": "8.9%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/639275543737.html"
			},
			{
				"title": "欧洲站2021撤柜品牌折扣衣服女装服装走份清仓批发进货拿货",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01nWIooo1uOsBV95LT9_!!2211841596028-0-cib.jpg",
				"promotion_price": "29.00",
				"price": "29.00",
				"sales": 30000,
				"num_iid": "647139965795",
				"seller_nick": "广州衣榀名库服饰有限公司",
				"tag_percent": "40.5%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/647139965795.html"
			},
			{
				"title": "shein欧美风格女装连衣裙 Cross-border Foreign Trade Wholesale",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01nK6why2JpJRfGwgm9_!!2212445239470-0-cib.jpg",
				"promotion_price": "6.30",
				"price": "6.30",
				"sales": 7000,
				"num_iid": "653492728284",
				"seller_nick": "东莞市虎门蕊馨服饰商行",
				"tag_percent": "0%",
				"area": "东莞市",
				"detail_url": "https://detail.1688.com/offer/653492728284.html"
			},
			{
				"title": "夏季新款百搭t恤女个性印花女装上衣韩版学生休闲宽松短袖女t恤潮",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/937/485/20143584739_878189286.jpg",
				"promotion_price": "8.00",
				"price": "8.00",
				"sales": 6000,
				"num_iid": "625972426073",
				"seller_nick": "深圳市宝安区索妍服装厂",
				"tag_percent": "8.3%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/625972426073.html"
			},
			{
				"title": "ebay速卖通2020爆款不规则亮片拼接大码女装连衣裙女8色8码",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/814/498/9025894418_262995774.jpg",
				"promotion_price": "23.50",
				"price": "23.50",
				"sales": 20000,
				"num_iid": "567653648450",
				"seller_nick": "深圳市宝安区岚雅图服饰批发商行",
				"tag_percent": "58.8%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/567653648450.html"
			},
			{
				"title": "短袖t恤女2021夏季新款白色休闲时尚圆领短袖韩版纯棉t恤衫女装",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN014IQoy01V0GUzZlvF8_!!2201213972590-0-cib.jpg",
				"promotion_price": "23.00",
				"price": "23.00",
				"sales": 20000,
				"num_iid": "651578435872",
				"seller_nick": "广州实粲贸易有限公司",
				"tag_percent": "12.8%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/651578435872.html"
			},
			{
				"title": "新款秋季法式复古碎花连衣裙中裙长袖女装显瘦雪纺连衣裙",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01jCdGuK1ZNOyvyav8P_!!2212434993182-0-cib.jpg",
				"promotion_price": "21.60",
				"price": "21.60",
				"sales": 3000,
				"num_iid": "653585573899",
				"seller_nick": "汕头市潮阳区铜盂苏筱蕾服装厂",
				"tag_percent": "25%",
				"area": "汕头市",
				"detail_url": "https://detail.1688.com/offer/653585573899.html"
			},
			{
				"title": "<品牌折扣女装>专柜库存女装特价清仓处理 便宜女装走份批发货源",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01uFV6vy1Rh54ZrdItv_!!2208020232142-0-cib.jpg",
				"promotion_price": "7.57",
				"price": "7.57",
				"sales": 20000,
				"num_iid": "654066083956",
				"seller_nick": "专柜尾货女装批发(广州)商行",
				"tag_percent": "33.3%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/654066083956.html"
			},
			{
				"title": "2021春秋新款女装长袖t恤韩版宽松女士上衣学生打底衫外贸批发网",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN0130GwhB1IWF9lHFOiM_!!2200714930900-0-cib.jpg",
				"promotion_price": "4.88",
				"price": "4.88",
				"sales": 10000,
				"num_iid": "651861237965",
				"seller_nick": "深圳市南山区美依亭服装商行",
				"tag_percent": "14.4%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/651861237965.html"
			},
			{
				"title": "2021秋季新款女装 小香风茶歇桔梗法式设计感雪纺碎花连衣裙子女",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VlXTY71HxtSCaKVBU_!!2211836950825-0-cib.jpg",
				"promotion_price": "58.00",
				"price": "58.00",
				"sales": 9000,
				"num_iid": "653095325054",
				"seller_nick": "广州瑾依娜服装厂",
				"tag_percent": "9.5%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/653095325054.html"
			},
			{
				"title": "实拍2021秋季新款黑色条纹拼接连衣裙女小个子收腰显瘦气质女装",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01GzVlBN2LPKCN70FeW_!!4034639684-0-cib.jpg",
				"promotion_price": "76.95",
				"price": "76.95",
				"sales": 10000,
				"num_iid": "651650636438",
				"seller_nick": "深圳市龙华区优依美服饰厂",
				"tag_percent": "13.2%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/651650636438.html"
			},
			{
				"title": "跨境欧美外贸女装WISH亚马逊新款春秋格子印花圆领长袖上衣T恤",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Ih2ilH22PLWG5Xs1u_!!2810987112-0-cib.jpg",
				"promotion_price": "19.00",
				"price": "19.00",
				"sales": 50000,
				"num_iid": "652354104762",
				"seller_nick": "深圳市南山区美衣季服饰厂",
				"tag_percent": "36.8%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/652354104762.html"
			},
			{
				"title": "秋季韩版新款女装长袖t恤 大码宽松圆领印花女士打底衫地摊批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN017SyOEN20BUIv6Dytp_!!1995796811-0-cib.jpg",
				"promotion_price": "4.80",
				"price": "4.80",
				"sales": 10000,
				"num_iid": "653781814300",
				"seller_nick": "深圳市宝安区西乡依贝利制衣厂",
				"tag_percent": "0%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/653781814300.html"
			},
			{
				"title": "2021女装跨境wish欧美ebay亚马逊纯色提花长袖衬衫拼接上衣气质现",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01sTza8X2KnJKKAv8qx_!!3836319601-0-cib.jpg",
				"promotion_price": "32.00",
				"price": "32.00",
				"sales": 20000,
				"num_iid": "652964049596",
				"seller_nick": "深圳市龙岗区诚精艺服饰厂",
				"tag_percent": "47.7%",
				"area": "东莞市",
				"detail_url": "https://detail.1688.com/offer/652964049596.html"
			},
			{
				"title": "欧美2021 新款秋冬季亚马逊女装爆款纯色性感圆领修身长袖t恤上衣",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VR3FaL1aHjhECHVUb_!!2206930993305-0-cib.jpg",
				"promotion_price": "20.00",
				"price": "20.00",
				"sales": 30000,
				"num_iid": "653056259966",
				"seller_nick": "东莞市卓达服饰有限公司",
				"tag_percent": "32.6%",
				"area": "东莞市",
				"detail_url": "https://detail.1688.com/offer/653056259966.html"
			},
			{
				"title": "实拍秋冬装女装高领德绒加厚保暖内搭修身打底衫长袖t恤上衣",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN015hgJx21oZVgdG23BO_!!2211407735239-0-cib.jpg",
				"promotion_price": "42.00",
				"price": "42.00",
				"sales": 20000,
				"num_iid": "652898686917",
				"seller_nick": "广州美雪妮服装厂",
				"tag_percent": "6.6%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/652898686917.html"
			},
			{
				"title": "亚马逊跨境2021秋新款文艺宽松大码女装纯色棉麻长袖衬衫连衣裙女",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01QQuQFo1cpkL989eJN_!!2211960933650-0-cib.jpg",
				"promotion_price": "32.28",
				"price": "32.28",
				"sales": 20000,
				"num_iid": "652935525543",
				"seller_nick": "广州卓依尔服装厂",
				"tag_percent": "12.3%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/652935525543.html"
			},
			{
				"title": "莫代尔长袖t恤女2021秋冬新款女装半高领打底衫内搭修身大码上衣",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01kTjFk21hkJipJAI7G_!!2206363674315-0-cib.jpg",
				"promotion_price": "12.50",
				"price": "12.50",
				"sales": 90000,
				"num_iid": "653321979053",
				"seller_nick": "东阳市逸翃服装有限公司",
				"tag_percent": "22.9%",
				"area": "东阳市",
				"detail_url": "https://detail.1688.com/offer/653321979053.html"
			},
			{
				"title": "韩版短袖T恤女学生宽松潮ins夏季女装2021新款上衣粉色简约BF百搭",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01r2Qgxn1HXKToJ3KAv_!!2212305510767-0-cib.jpg",
				"promotion_price": "29.98",
				"price": "29.98",
				"sales": 5000,
				"num_iid": "652292577754",
				"seller_nick": "晋江市永和镇悦冠服装厂",
				"tag_percent": "8.5%",
				"area": "泉州市",
				"detail_url": "https://detail.1688.com/offer/652292577754.html"
			}
		],
		"data_from": "1688app"
	},
	"call_args": {
		"q": "女装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0",
		"page_size": "40"
	}
}