淘宝联盟API

京东联盟API

数据接口API

点击获取APKEY

正常关键字商品查询接口(新) 接口测试

接口地址： http://api.web.ecapi.cn/suning/getSearchItems

接口实例： http://api.web.ecapi.cn/suning/getSearchItems?apkey=登录会员中心查看

注意事项：如调用接口时数据返回异常，则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码，然后再试。

请求方式：GET

会员范围：免费会员 (新用户注册立刻送7天V1付费会员【注：赠送会员可使用全部接口，但调用频率与免费会员一致，免费会员调用频率可参考会员等级说明】)

必看注意：为保障接口安全及使用效率，调用本站接口前需先添加IP白名单 (IP地址测试)，若IP不固定且无服务器，可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口，禁止将接口重新打包销售或转卖，一经发现，将做帐号封禁处理。

优惠推荐：高性能云服务器2折起，普惠上云，仅需234元/年 ->>立即抢购<<-。

使用说明: 暂无说明

请求参数

参数	类型	请求参数参考值	是否必须	说明
apkey	String	xxxxxxx	是	用户中心 - 系统设置 - 平台设置中查看APKEY密钥 (点我获取)（*必要）
pageIndex	String	1		页码默认为1
keyword	String	手机		关键字
saleCategoryCode	String			销售目录ID
cityCode	String	025		城市编码默认025
suningService	String			是否苏宁自营默认为空，1：是
pgSearch	String			是否拼购默认为空 1：是
startPrice	String			开始价格
endPrice	String			结束价格
sortType	String	1		排序规则 1：综合（默认） 2：销量由高到低 3：价格由高到低 4：价格由低到高 5：佣金比例由高到低 6：佣金金额由高到低 7：两个维度，佣金金额由高到低，销量由高到低8：近30天推广量由高到低9：近30天支出佣金金额由高到低。
picWidth	String			图片宽度默认200
picHeight	String	200		图片高度默认200
size	String	10		每页条数默认10
branch	String	1		1：减枝 2：不减枝 sortType=1（综合）默认不剪枝其他排序默认剪枝
coupon	String			1：有券；其他：全部
snfwservice	String			是否苏宁服务 1:是
snhwg	String			是否苏宁国际 1:是

返回参数

返回参数	类型	参数说明	扩展说明
list	Json	商品列表
├　commodityInfo	Json	商品信息
├　　├　pictureUrl	Json	商品图片
├　　├　　├　picUrl	String	图片URL
├　　├　　├　locationId	String	图片位置
├　　├　saleStatus	Number	是否可售	0:可售，1:无货，2:本地暂不销售
├　　├　rate	String	佣金比例	数值为百分比数据
├　　├　baoyou	Number	是否包邮	0：不包邮 1：包邮
├　　├　priceTypeCode	Number	价格类型编码	0：正常价格，1：大聚惠， 2：抢购， 3：渠道专享， 4：限时促销，5：爆款抢购，6：掌上抢，7：特卖，99：乐拼购
├　　├　priceType	String	价格类型
├　　├　commodityType	Number	商品类型	1：自营 2：C店 3：海外购自营 4：海外购 5:特卖 6：极物
├　　├　commodityPrice	String	商品价格
├　　├　snPrice	String	易购价
├　　├　monthSales	Number	月销量
├　　├　sellingPoint	String	卖点
├　　├　supplierName	String	供应商名称
├　　├　supplierCode	String	供应商编码
├　　├　commodityCode	String	商品编码
├　　├　commodityName	String	商品名称
├　pgInfo	Json	拼团信息
├　　├　pgActionId	String	拼购活动ID
├　　├　pgUrl	String	拼购四级页地址
├　　├　pgPrice	String	拼购价
├　　├　pgNum	String	成团人数
├　categoryInfo	Json	分类信息
├　　├　goodsGroupCategoryName	String	商品组目录名称
├　　├　goodsGroupCategoryId	String	商品组目录ID
├　　├　thirdPurchaseCategoryName	String	三级采购目录名称
├　　├　thirdPurchaseCategoryId	String	三级采购目录ID
├　　├　secondPurchaseCategoryName	String	二级采购目录名称
├　　├　secondPurchaseCategoryId	String	二级采购目录ID
├　　├　firstPurchaseCategoryName	String	一级采购目录名称
├　　├　firstPurchaseCategoryId	String	一级采购目录ID
├　　├　thirdSaleCategoryName	String	三级销售目录名称
├　　├　thirdSaleCategoryId	String	三级销售目录ID
├　　├　secondSaleCategoryName	String	二级销售目录名称
├　　├　secondSaleCategoryId	String	二级销售目录ID
├　　├　firstSaleCategoryName	String	一级销售目录名称
├　　├　firstSaleCategoryId	String	一级销售目录ID
├　couponInfo	Json	优惠券信息
├　　├　afterCouponPrice	String	券后价
├　　├　activityDescription	String	活动描述
├　　├　bounsLimit	String	基数数值
├　　├　endTime	String	券使用结束时间
├　　├　startTime	String	券使用开始时间
├　　├　couponEndTime	String	券领取结束时间
├　　├　couponStartTime	String	券领取开始时间
├　　├　couponCount	String	券总数
├　　├　couponValue	String	券面额
├　　├　activitySecretKey	String	券秘钥
├　　├　activityId	String	券活动编码
├　　├　couponUrl	String	券链接URL
├　advanceSale	Json	预售信息
├　　├　depositEndTime	String	付定金结束时间
├　　├　depositAmount	String	定金
├　　├　isReserveCommodity	String	是否预售	1:是 0:否

Json返回示例: {"code":200,"data":{"list":[{"commodityInfo":{"commodityName":"【商品页面两瓶券后99元】派威顿骑士-莫雷顿XO白兰地法国洋酒进口铁塔白兰地洋酒礼盒装","commodityCode":"11923133417","supplierCode":"0071171234","supplierName":"南京酒富盛名酒水拼购专营店","pictureUrl":[{"picUrl":"https://imgservice.suning.cn/uimg1/b2c/image/81cm9ydIbbloTu3HWxwzlQ.jpg_200w_200h_4e","locationId":1},{"picUrl":"https://imgservice.suning.cn/uimg1/b2c/image/MZs0aGqqJI_sneOhh6XxEg.jpg_200w_200h_4e","locationId":2},{"picUrl":"https://imgservice.suning.cn/uimg1/b2c/image/RHPPDKjX0ITuzPZjr5R_OA.jpg_200w_200h_4e","locationId":3},{"picUrl":"https://imgservice.suning.cn/uimg1/b2c/image/RSc1ygE64I5FnE14dYBvTw.jpg_200w_200h_4e","locationId":4}],"sellingPoint":"酒体醇厚、香气十足","monthSales":955,"snPrice":"1980.00","commodityPrice":"199.50","commodityType":2,"priceType":"乐拼购","priceTypeCode":99,"baoyou":1,"rate":"16.25","saleStatus":0},"pgInfo":{"pgNum":"2","pgPrice":"199.50","pgUrl":"https://pin.suning.com/pgs/product/55623905961368323417.html","pgActionId":"55623905961368323417"},"categoryInfo":{"firstSaleCategoryId":"500354","firstSaleCategoryName":"进口食品","secondSaleCategoryId":"500355","secondSaleCategoryName":"进口酒水","thirdSaleCategoryId":"501420","thirdSaleCategoryName":"进口洋酒","firstPurchaseCategoryId":"R9915","firstPurchaseCategoryName":"进口酒水","secondPurchaseCategoryId":"R9692","secondPurchaseCategoryName":"进口酒","thirdPurchaseCategoryId":"R9833","thirdPurchaseCategoryName":"进口洋酒","goodsGroupCategoryId":"R7403002","goodsGroupCategoryName":"白兰地"},"couponInfo":{"couponUrl":"https://quan.suning.com/lqzx_recommend.do?activityId=202007020013541943&activitySecretKey=j9fsWMGkszVFnBxL3XzYMApD","activityId":"202007020013541943","activitySecretKey":"j9fsWMGkszVFnBxL3XzYMApD","couponValue":"300.00","couponCount":"20000","couponStartTime":"2020-07-02 10:02:00","couponEndTime":"2020-07-04 23:55:59","startTime":"2020-07-02 10:02:31","endTime":"2020-07-04 23:55:59","bounsLimit":"399.00","activityDescription":"店铺易券(300元)","afterCouponPrice":null},"advanceSale":{"isReserveCommodity":"0","depositAmount":"","depositEndTime":""}}]},"msg":"success"}

code/http_status说明

code/http_status	说明
200	数据获取成功
-1	数据获取失败
401	IP没有添加白名单
429	访问次数超限
403	关键参数丢失
405	请求方式不对

【公告】

数据接口API

正常关键字商品查询接口(新) 接口测试

使用说明

请求参数

返回参数

Json返回示例

code/http_status说明

电话：0531-6896-1851

数据接口API

正常 关键字商品查询接口(新) 接口测试

使用说明

请求参数

返回参数

Json返回示例

code/http_status说明

电话：0531-6896-1851

正常关键字商品查询接口(新) 接口测试