淘宝客API
京东API
拼多多API
唯品会API
苏宁API
开放平台API
美团平台
点击获取APKEY

正常 (重构版)关键字商品查询接口(新)

更新时间:2020-09-03 12:39:51

请求链接: http://api.web.ecapi.cn/suning/getSearchItems
请求实例: http://api.web.ecapi.cn/suning/getSearchItems?apkey=登录后即可显示 (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
今日调用统计: 暂无统计
会员限制: 免费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明:
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-
限时推广:送你100元借款优惠券!借款时可用。(数量有限,先到先得) ->>立即领取<<-

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点击进入)*必要
pageIndexString1页码 默认为1
keywordString手机关键字
saleCategoryCodeString销售目录ID
cityCodeString025城市编码 默认025
suningServiceString是否苏宁自营 默认为空,1:是
pgSearchString是否拼购 默认为空 1:是
startPriceString开始价格
endPriceString结束价格
sortTypeString1排序规则 1:综合(默认) 2:销量由高到低 3:价格由高到低 4:价格由低到高 5:佣金比例由高到低 6:佣金金额由高到低 7:两个维度,佣金金额由高到低,销量由高到低8:近30天推广量由高到低9:近30天支出佣金金额由高到低。
picWidthString图片宽度 默认200
picHeightString200图片高度 默认200
sizeString10每页条数 默认10
branchString11:减枝 2:不减枝 sortType=1(综合) 默认不剪枝 其他排序默认剪枝
couponString1:有券;其他:全部
snfwserviceString是否苏宁服务 1:是
snhwgString是否苏宁国际 1:是

返回参数

返回参数类型参数说明扩展说明
listJson商品列表
 ├ commodityInfoJson商品信息
 ├  ├ pictureUrlJson商品图片
 ├  ├  ├ picUrlString图片URL
 ├  ├  ├ locationIdString图片位置
 ├  ├ saleStatusNumber是否可售0:可售,1:无货,2:本地暂不销售
 ├  ├ rateString佣金比例数值为百分比数据
 ├  ├ baoyouNumber是否包邮0:不包邮 1:包邮
 ├  ├ priceTypeCodeNumber价格类型编码0:正常价格,1:大聚惠 , 2:抢购, 3:渠道专享, 4:限时促销 ,5:爆款抢购,6:掌上抢,7:特卖,99:乐拼购
 ├  ├ priceTypeString价格类型
 ├  ├ commodityTypeNumber商品类型1:自营 2:C店 3:海外购自营 4:海外购 5:特卖 6:极物
 ├  ├ commodityPriceString商品价格
 ├  ├ snPriceString易购价
 ├  ├ monthSalesNumber月销量
 ├  ├ sellingPointString卖点
 ├  ├ supplierNameString供应商名称
 ├  ├ supplierCodeString供应商编码
 ├  ├ commodityCodeString商品编码
 ├  ├ commodityNameString商品名称
 ├ pgInfoJson拼团信息
 ├  ├ pgActionIdString拼购活动ID
 ├  ├ pgUrlString拼购四级页地址
 ├  ├ pgPriceString拼购价
 ├  ├ pgNumString成团人数
 ├ categoryInfoJson分类信息
 ├  ├ goodsGroupCategoryNameString商品组目录名称
 ├  ├ goodsGroupCategoryIdString商品组目录ID
 ├  ├ thirdPurchaseCategoryNameString三级采购目录名称
 ├  ├ thirdPurchaseCategoryIdString三级采购目录ID
 ├  ├ secondPurchaseCategoryNameString二级采购目录名称
 ├  ├ secondPurchaseCategoryIdString二级采购目录ID
 ├  ├ firstPurchaseCategoryNameString一级采购目录名称
 ├  ├ firstPurchaseCategoryIdString一级采购目录ID
 ├  ├ thirdSaleCategoryNameString三级销售目录名称
 ├  ├ thirdSaleCategoryIdString三级销售目录ID
 ├  ├ secondSaleCategoryNameString二级销售目录名称
 ├  ├ secondSaleCategoryIdString二级销售目录ID
 ├  ├ firstSaleCategoryNameString一级销售目录名称
 ├  ├ firstSaleCategoryIdString一级销售目录ID
 ├ couponInfoJson优惠券信息
 ├  ├ afterCouponPriceString券后价
 ├  ├ activityDescriptionString活动描述
 ├  ├ bounsLimitString基数数值
 ├  ├ endTimeString券使用结束时间
 ├  ├ startTimeString券使用开始时间
 ├  ├ couponEndTimeString券领取结束时间
 ├  ├ couponStartTimeString券领取开始时间
 ├  ├ couponCountString券总数
 ├  ├ couponValueString券面额
 ├  ├ activitySecretKeyString券秘钥
 ├  ├ activityIdString券活动编码
 ├  ├ couponUrlString券链接URL
 ├ advanceSaleJson预售信息
 ├  ├ depositEndTimeString付定金结束时间
 ├  ├ depositAmountString定金
 ├  ├ isReserveCommodityString是否预售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数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对