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