简化操作教会你如何使用接口，利用关键词搜索技术获取1688的商品数据

item_search-按关键字搜索商品前往注册开通测试

onebound.1688.item_search

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：q=溜冰鞋&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_credit]
(bid:总价,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数 page_size:每页宝贝数量，默认40
filter:额外的过滤参数，如：filter=filtId:1,2,3,4;activityType:1,2,3,4;city:天津;quantityBegin:1000
filtId 过滤：48小时发货,7+天包换,赠运费险,免费赊账;
activityType 优惠类型:包邮，产地货源，伙拼，手机专享价
city 地区：地区名
quantityBegin 起订量：数字\

响应参数

Version: Date:

名称	类型	描述
items	items[]	按关键字搜索商品
page	Int	页码
real_total_results	Int	宝贝数量
total_results	Int	宝贝数量
page_size	Int	接口返回数量
pagecount	Int	总页数
data_from	String
item	item[]	宝贝详情数据

请求示例

Curl
PHP
PHPsdk
JAVA
C#
Python


-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/1688/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=溜冰鞋&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter="

响应示例

{"items": {"page": "1","real_total_results": 1900,"total_results": 1900,"page_size": 19,"pagecount": 100,"item": [{"title": "伴威溜冰鞋 儿童全套装男童女童轮滑鞋 可调节大小双排四轮旱冰鞋","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01QkXX8k1lU46zGzrrL_!!2974844821-0-cib.jpg","promotion_price": "23.00","price": "23.00","sales": 15844,"turnover": "1万+","num_iid": "645035674278","seller_nick": "余姚市高丰电器厂","tag_percent": "24%","area": "余姚市","detail_url": "https://detail.1688.com/offer/645035674278.html"},{"title": "亚马逊热销 可调节儿童全闪光直排单排旱冰鞋溜冰鞋四轮 轮滑套装","pic_url": "https://cbu01.alicdn.com/img/ibank/2019/613/775/10513577316_494569115.jpg","promotion_price": "58.00","price": "58.00","sales": 31334,"turnover": "1万+","num_iid": "608395822332","seller_nick": "永康市阿布屋工贸有限公司","tag_percent": "15%","area": "永康市","detail_url": "https://detail.1688.com/offer/608395822332.html"},{"title": "溜冰鞋成人成年旱冰直排轮滑冰鞋儿童全套装大学生初学者男女专业","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01G85QtD1GEGPgLmfFC_!!2212631390590-0-cib.jpg","promotion_price": "88.00","price": "88.00","sales": 30412,"turnover": "16万+","num_iid": "656991439665","seller_nick": "宁波焙金信息科技有限公司","tag_percent": "25%","area": "宁波市","detail_url": "https://detail.1688.com/offer/656991439665.html"},{"title": "厂家供应斯威PU单闪儿童可调男女轮滑鞋溜冰鞋直排旱滑冰鞋无护套","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ItRbLB1O4ezkeUpgW_!!2201482881652-0-cib.jpg","promotion_price": "99.90","price": "99.90","sales": 16450,"turnover": "9万+","num_iid": "650213695638","seller_nick": "永康市威罗华兹工贸有限公司","tag_percent": "22%","area": "永康市","detail_url": "https://detail.1688.com/offer/650213695638.html"},{"title": "【月销5000】斯威专业平花轮滑鞋女童专业儿童大学生成人初学者","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01jD8T2d1O4f3Zfy2Qq_!!2201482881652-0-cib.jpg","promotion_price": "189.00","price": "189.00","sales": 324,"turnover": "2万+","num_iid": "674434777502","seller_nick": "永康市威罗华兹工贸有限公司","tag_percent": "22%","area": "永康市","detail_url": "https://detail.1688.com/offer/674434777502.html"},{"title": "厂家直销单闪光儿童可调男女轮滑鞋溜冰鞋直排旱滑冰鞋无护套代发","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01CC46ks1O4f1AT4r4l_!!2201482881652-0-cib.jpg","promotion_price": "149.00","price": "149.00","sales": 23480,"turnover": "16万+","num_iid": "659234248078","seller_nick": "永康市威罗华兹工贸有限公司","tag_percent": "22%","area": "永康市","detail_url": "https://detail.1688.com/offer/659234248078.html"},{"title": "斯威国潮平花初学成人轮滑鞋直排单排儿童溜冰鞋成人旱冰鞋可调节","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vbozlb1O4f0jHr2VW_!!2201482881652-0-cib.jpg","promotion_price": "149.00","price": "149.00","sales": 27866,"turnover": "7万+","num_iid": "633691081986","seller_nick": "永康市威罗华兹工贸有限公司","tag_percent": "22%","area": "永康市","detail_url": "https://detail.1688.com/offer/633691081986.html"},{"title": "厂家供应斯威正品儿童专业轮滑鞋初学者全套批发溜冰滑冰鞋代发","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01kKWnin1O4f3GYkZhK_!!2201482881652-0-cib.jpg","promotion_price": "169.00","price": "169.00","sales": 1088,"turnover": "3万+","num_iid": "672735973556","seller_nick": "永康市威罗华兹工贸有限公司","tag_percent": "22%","area": "永康市","detail_url": "https://detail.1688.com/offer/672735973556.html"},{"title": "美洲狮青少年直排轮滑鞋溜冰鞋成人男女旱冰鞋滑冰鞋大学生初学者","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lipHem2A8Pr1OWRD8_!!3160608158-0-cib.jpg","promotion_price": "248.00","price": "248.00","sales": 3824,"turnover": "1000+","num_iid": "545088074424","seller_nick": "广州市蒙特莱运动器材有限公司","tag_percent": "12%","area": "广州市","detail_url": "https://detail.1688.com/offer/545088074424.html"},{"title": "飞鸽儿童溜冰鞋男童女童全套闪光旱冰轮滑鞋初学者小孩直排轮可调","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN011o95CP1foJztCK4cV_!!2213257564053-0-cib.jpg","promotion_price": "94.80","price": "94.80","sales": 95,"turnover": "5000+","num_iid": "676621397385","seller_nick": "义乌市献旭电子商务商行","tag_percent": "5%","area": "金华市","detail_url": "https://detail.1688.com/offer/676621397385.html"},{"title": "溜冰鞋儿童闪光直排轮滑鞋旱冰鞋滑冰鞋可调节男女","pic_url": "https://cbu01.alicdn.com/img/ibank/2020/868/191/18447191868_1290627328.jpg","promotion_price": "40.00","price": "40.00","sales": 7154,"turnover": "1万+","num_iid": "623883167826","seller_nick": "武义觉美体育用品有限公司","tag_percent": "17%","area": "武义县","detail_url": "https://detail.1688.com/offer/623883167826.html"},{"title": "乐秀RX1S溜冰鞋儿童全套装滑轮冰鞋专业轮滑鞋旱冰鞋男女童初学者","pic_url": "https://cbu01.alicdn.com/img/ibank/2020/320/106/13307601023_36121263.jpg","promotion_price": "288.00","price": "288.00","sales": 90,"turnover": "3000+","num_iid": "641601753887","seller_nick": "漯河市郾城区乐秀轮滑","tag_percent": "8%","area": "漯河市","detail_url": "https://detail.1688.com/offer/641601753887.html"},{"title": "厂家儿童成人男女双排轮滑鞋马卡龙色舒适四轮旱冰双排溜冰鞋","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01xGEdqY1kWyz3y9vGv_!!6000000004692-0-cib.jpg","promotion_price": "90.00","price": "90.00","sales": 10776,"turnover": "1000+","num_iid": "634071065534","seller_nick": "慈溪市天元镇沪峰体育用品器材厂","tag_percent": "9%","area": "宁波市","detail_url": "https://detail.1688.com/offer/634071065534.html"},{"title": "溜冰鞋儿童全套装可调闪光直排轮小孩轮滑鞋滑冰鞋旱冰鞋男童女童","pic_url": "https://cbu01.alicdn.com/img/ibank/2020/384/215/14313512483_1099994751.jpg","promotion_price": "67.00","price": "67.00","sales": 7526,"turnover": "1万+","num_iid": "600874462921","seller_nick": "武义亚美贸易有限公司","tag_percent": "25%","area": "武义县","detail_url": "https://detail.1688.com/offer/600874462921.html"},{"title": "厂家批发溜冰鞋儿童轮滑鞋旱冰鞋滑冰鞋成年直排可调单闪光单鞋","pic_url": "https://cbu01.alicdn.com/img/ibank/2018/285/680/9389086582_35160820.jpg","promotion_price": "39.00","price": "39.00","sales": 1535,"turnover": "2万+","num_iid": "577165748868","seller_nick": "武义佰博体育用品有限公司","tag_percent": "25%","area": "武义县","detail_url": "https://detail.1688.com/offer/577165748868.html"},{"title": "PVC儿童溜冰鞋通用轮滑鞋成人滑轮速滑旱冰鞋侨丰滑行暴走鞋批发","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01jNnTva1zPOfbI3Tof_!!985216706-0-cib.jpg","promotion_price": "48.00","price": "48.00","sales": 351944,"turnover": "22万+","num_iid": "39318349737","seller_nick": "永康市鑫思蓬健身器材有限公司","tag_percent": "33%","area": "永康市","detail_url": "https://detail.1688.com/offer/39318349737.html"},{"title": "迪卡仕D981溜冰鞋儿童全套装滑冰轮滑鞋旱冰中大童专业男女初学者","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Qb4uxO1eQfrstBlkO_!!2211593593866-0-cib.jpg","promotion_price": "86.80","price": "86.80","sales": 2582,"turnover": "4万+","num_iid": "643998993176","seller_nick": "徐州迪卡仕电子商务有限公司","tag_percent": "20%","area": "徐州市","detail_url": "https://detail.1688.com/offer/643998993176.html"},{"title": "高鑫品牌 溜冰鞋儿童款女 可调闪光直排滑冰滑轮鞋 儿童旱冰鞋","pic_url": "https://cbu01.alicdn.com/img/ibank/2020/425/940/13726049524_1672106024.jpg","promotion_price": "85.00","price": "85.00","sales": 1927,"turnover": "2万+","num_iid": "583863722864","seller_nick": "浙江高鑫工贸有限公司","tag_percent": "16%","area": "永康市","detail_url": "https://detail.1688.com/offer/583863722864.html"},{"title": "厂家供应轮滑鞋溜冰鞋儿童款初学专业全套装男童女童批发全闪正品","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01O0hQGE1O4f3c4MuZr_!!2201482881652-0-cib.jpg","promotion_price": "89.90","price": "89.90","sales": 2656,"turnover": "21万+","num_iid": "674857556441","seller_nick": "永康市威罗华兹工贸有限公司","tag_percent": "22%","area": "永康市","detail_url": "https://detail.1688.com/offer/674857556441.html"},{"title": "炫克X2轮滑鞋儿童溜冰鞋可调男女花式直排轮旱冰鞋2-6-8-12岁","pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN014vQ5uu1ig1eRy2sIM_!!2212037304441-0-cib.jpg","promotion_price": "165.00","price": "165.00","sales": 17,"turnover": "100+","num_iid": "661556424101","seller_nick": "郁南县都城镇桂荣体育用品商行","tag_percent": "22%","area": "南宁市","detail_url": "https://detail.1688.com/offer/661556424101.html"}],"data_from": "ti"},"error_code": "0000","reason": "ok","secache": "27c2f476dca8ced8fb6a68eebe943345","secache_time": 1663465349,"secache_date": "2022-09-18 09:42:29","translate_status": "","translate_time": 0,"language": {"default_lang": "cn","current_lang": "cn"},"error": "","cache": 0,"api_info": "today:12 max:10100 all[35=12+4+19];expires:2030-12-31","execution_time": "1.511","server_time": "Beijing/2022-09-18 09:42:29","client_ip": "106.6.39.60","call_args": {"q": "溜冰鞋","start_price": "0","end_price": "0","page": "1","cat": "0","page_size": "40"},"api_type": "1688","translate_language": "zh-CN","translate_engine": "google_new","server_memory": "1.26MB","request_id": "gw-4.6326778475264","last_id": "1223051729"
}