API接口目录

网盟业务

会员API
联盟订单API
大聚惠API
联盟商品API
招商推广活动API
获取推广链接API
优惠券推广API
机构推客API
店铺API
异常码自查工具
suning.netalliance.searchcommoditynew.query 关键字商品查询接口(新),准备下线
¥免费

关键字商品查询接口(新)

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageIndexStringN1页码 默认为1
keywordStringN手机关键字
saleCategoryCodeStringN50000销售目录ID
cityCodeStringN025城市编码 默认025
suningServiceStringN1是否苏宁自营 默认为空,1:是
pgSearchStringN1是否拼购 默认为空 1:是
startPriceStringN10.00开始价格
endPriceStringN20.00结束价格
sortTypeStringN1 排序规则 1:综合(默认) 2:销量由高到低 3:价格由高到低 4:价格由低到高 5:佣金比例由高到低 6:佣金金额由高到低 7:两个维度,佣金金额由高到低,销量由高到低8:近30天推广量由高到低9:近30天支出佣金金额由高到低。
picWidthStringN200图片宽度 默认200
picHeightStringN200图片高度 默认200
sizeStringN10每页条数 默认10
branchStringN11:减枝 2:不减枝 sortType=1(综合) 默认不剪枝 其他排序默认剪枝
couponStringN11:有券;其他:全部
snfwserviceStringN1是否苏宁服务 1:是
snhwgStringN1是否苏宁国际 1:是
响应参数
名称 类型 示例值 描述
commodityListString
commodityInfoString
commodityNameString商品名称示例商品名称
commodityCodeString761137021商品编码
supplierCodeString0000000000供应商编码
supplierNameString供应商名称示例供应商名称
pictureUrlString
locationIdString1图片位置
picUrlStringhttp://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e图片Url
sellingPointString商品卖点示例商品卖点
monthSalesString100月销量
snPriceString100.00易购价
commodityPriceString99.00商品价格
commodityTypeString1商品类型 1:自营 2:C店 3:海外购自营 4:海外购 5:特卖 6:极物
priceTypeString大聚惠价格类型
priceTypeCodeString1 价格类型编码 0:正常价格,1:大聚惠 , 2:抢购, 3:渠道专享, 4:限时促销 ,5:爆款抢购,6:掌上抢,7:特卖,99:乐拼购
baoyouString1是否包邮 0:不包邮 1:包邮
rateString20.00佣金比例 (数值为百分比数据)
saleStatusString0是否可售 0:可售,1:无货,2:本地暂不销售
pgInfoString
pgNumString2成团人数
pgPriceString20.00拼购价
pgUrlStringhttps://pin.suning.com/pgs/product/45918238111498247256.html拼购四级页地址
pgActionIdString45918238111498247256拼购活动ID
categoryInfoString
firstSaleCategoryIdString50000一级销售目录ID
firstSaleCategoryNameString一级销售目录名称示例一级销售目录名称
secondSaleCategoryIdString50000二级销售目录ID
secondSaleCategoryNameString二级销售目录名称示例二级销售目录名称
thirdSaleCategoryIdString50000三级销售目录ID
thirdSaleCategoryNameString三级销售目录名称示例三级销售目录名称
firstPurchaseCategoryIdStringR001一级采购目录ID
firstPurchaseCategoryNameString一级采购目录名称示例一级采购目录名称
secondPurchaseCategoryIdStringR002二级采购目录ID
secondPurchaseCategoryNameString二级采购目录名称示例二级采购目录名称
thirdPurchaseCategoryIdStringR003三级采购目录ID
thirdPurchaseCategoryNameString三级采购目录名称示例三级采购目录名称
goodsGroupCategoryIdStringR9001213商品组目录ID
goodsGroupCategoryNameString商品组目录名称示例商品组目录名称
couponInfoString
couponUrlStringhttps://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM券链接URL
activityIdString201907040010040371券活动编码
activitySecretKeyStringmzekhfSGwaRrZIopV0M1wGRM券秘钥
couponValueString10.00券面额
couponCountString100券总数
couponStartTimeString2019-07-04 17:10:47券领取开始时间
couponEndTimeString2019-07-04 17:10:47券领取结束时间
startTimeString2019-07-04 17:10:47券使用开始时间
endTimeString2019-07-04 17:10:47券使用结束时间
bounsLimitString15.00基数数值
activityDescriptionString免费领取送券10元活动描述
advanceSaleString
isReserveCommodityString1是否预售 1:是 0:否
depositAmountString200定金
depositEndTimeString2017-10-10 10:00:00付定金结束时间
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <querySearchcommoditynew>
      <picWidth>200</picWidth>
      <startPrice>10.00</startPrice>
      <picHeight>200</picHeight>
      <coupon>1</coupon>
      <cityCode>025</cityCode>
      <saleCategoryCode>50000</saleCategoryCode>
      <endPrice>20.00</endPrice>
      <branch>1</branch>
      <suningService>1</suningService>
      <size>10</size>
      <pageIndex>1</pageIndex>
      <snhwg>1</snhwg>
      <sortType>1</sortType>
      <snfwservice>1</snfwservice>
      <pgSearch>1</pgSearch>
      <keyword>手机</keyword>
    </querySearchcommoditynew>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "querySearchcommoditynew": {
        "picWidth": "200",
        "startPrice": "10.00",
        "picHeight": "200",
        "coupon": "1",
        "cityCode": "025",
        "saleCategoryCode": "50000",
        "endPrice": "20.00",
        "branch": "1",
        "suningService": "1",
        "size": "10",
        "pageIndex": "1",
        "snhwg": "1",
        "sortType": "1",
        "snfwservice": "1",
        "pgSearch": "1",
        "keyword": "手机"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <querySearchcommoditynew>
      <commodityList>
        <advanceSale>
          <depositAmount>200</depositAmount>
          <depositEndTime>2017-10-10 10:00:00</depositEndTime>
          <isReserveCommodity>1</isReserveCommodity>
        </advanceSale>
        <couponInfo>
          <activitySecretKey>mzekhfSGwaRrZIopV0M1wGRM</activitySecretKey>
          <bounsLimit>15.00</bounsLimit>
          <couponEndTime>2019-07-04 17:10:47</couponEndTime>
          <activityId>201907040010040371</activityId>
          <couponStartTime>2019-07-04 17:10:47</couponStartTime>
          <couponCount>100</couponCount>
          <couponUrl>https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&amp;activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM</couponUrl>
          <startTime>2019-07-04 17:10:47</startTime>
          <activityDescription>免费领取送券10元</activityDescription>
          <endTime>2019-07-04 17:10:47</endTime>
          <couponValue>10.00</couponValue>
        </couponInfo>
        <pgInfo>
          <pgUrl>https://pin.suning.com/pgs/product/45918238111498247256.html</pgUrl>
          <pgActionId>45918238111498247256</pgActionId>
          <pgNum>2</pgNum>
          <pgPrice>20.00</pgPrice>
        </pgInfo>
        <categoryInfo>
          <firstPurchaseCategoryId>R001</firstPurchaseCategoryId>
          <secondPurchaseCategoryId>R002</secondPurchaseCategoryId>
          <goodsGroupCategoryId>R9001213</goodsGroupCategoryId>
          <firstPurchaseCategoryName>一级采购目录名称示例</firstPurchaseCategoryName>
          <thirdSaleCategoryId>50000</thirdSaleCategoryId>
          <secondSaleCategoryId>50000</secondSaleCategoryId>
          <secondSaleCategoryName>二级销售目录名称示例</secondSaleCategoryName>
          <goodsGroupCategoryName>商品组目录名称示例</goodsGroupCategoryName>
          <firstSaleCategoryId>50000</firstSaleCategoryId>
          <thirdPurchaseCategoryId>R003</thirdPurchaseCategoryId>
          <firstSaleCategoryName>一级销售目录名称示例</firstSaleCategoryName>
          <thirdSaleCategoryName>三级销售目录名称示例</thirdSaleCategoryName>
          <thirdPurchaseCategoryName>三级采购目录名称示例</thirdPurchaseCategoryName>
          <secondPurchaseCategoryName>二级采购目录名称示例</secondPurchaseCategoryName>
        </categoryInfo>
        <commodityInfo>
          <supplierName>供应商名称示例</supplierName>
          <pictureUrl>
            <picUrl>http://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e</picUrl>
            <locationId>1</locationId>
          </pictureUrl>
          <priceType>大聚惠</priceType>
          <baoyou>1</baoyou>
          <sellingPoint>商品卖点示例</sellingPoint>
          <saleStatus>0</saleStatus>
          <supplierCode>0000000000</supplierCode>
          <commodityPrice>99.00</commodityPrice>
          <commodityType>1</commodityType>
          <monthSales>100</monthSales>
          <snPrice>100.00</snPrice>
          <priceTypeCode>1</priceTypeCode>
          <rate>20.00</rate>
          <commodityCode>761137021</commodityCode>
          <commodityName>商品名称示例</commodityName>
        </commodityInfo>
      </commodityList>
    </querySearchcommoditynew>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "querySearchcommoditynew": {
        "commodityList": [
          {
            "advanceSale": {
              "depositAmount": "200",
              "depositEndTime": "2017-10-10 10:00:00",
              "isReserveCommodity": "1"
            },
            "couponInfo": {
              "activitySecretKey": "mzekhfSGwaRrZIopV0M1wGRM",
              "bounsLimit": "15.00",
              "couponEndTime": "2019-07-04 17:10:47",
              "activityId": "201907040010040371",
              "couponStartTime": "2019-07-04 17:10:47",
              "couponCount": "100",
              "couponUrl": "https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM",
              "startTime": "2019-07-04 17:10:47",
              "activityDescription": "免费领取送券10元",
              "endTime": "2019-07-04 17:10:47",
              "couponValue": "10.00"
            },
            "pgInfo": {
              "pgUrl": "https://pin.suning.com/pgs/product/45918238111498247256.html",
              "pgActionId": "45918238111498247256",
              "pgNum": "2",
              "pgPrice": "20.00"
            },
            "categoryInfo": {
              "firstPurchaseCategoryId": "R001",
              "secondPurchaseCategoryId": "R002",
              "goodsGroupCategoryId": "R9001213",
              "firstPurchaseCategoryName": "一级采购目录名称示例",
              "thirdSaleCategoryId": "50000",
              "secondSaleCategoryId": "50000",
              "secondSaleCategoryName": "二级销售目录名称示例",
              "goodsGroupCategoryName": "商品组目录名称示例",
              "firstSaleCategoryId": "50000",
              "thirdPurchaseCategoryId": "R003",
              "firstSaleCategoryName": "一级销售目录名称示例",
              "thirdSaleCategoryName": "三级销售目录名称示例",
              "thirdPurchaseCategoryName": "三级采购目录名称示例",
              "secondPurchaseCategoryName": "二级采购目录名称示例"
            },
            "commodityInfo": {
              "supplierName": "供应商名称示例",
              "pictureUrl": {
                "picUrl": "http://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e",
                "locationId": "1"
              },
              "priceType": "大聚惠",
              "baoyou": "1",
              "sellingPoint": "商品卖点示例",
              "saleStatus": "0",
              "supplierCode": "0000000000",
              "commodityPrice": "99.00",
              "commodityType": "1",
              "monthSales": "100",
              "snPrice": "100.00",
              "priceTypeCode": "1",
              "rate": "20.00",
              "commodityCode": "761137021",
              "commodityName": "商品名称示例"
            }
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
isp.sys.service.unavailable.sumis 服务不可用 请联系苏宁技术人员
biz.netalliance.querysearchcommoditynew.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.netalliance.querysearchcommoditynew.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.suis 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ