API接口目录

网盟业务

会员API
联盟订单API
大聚惠API
联盟商品API
招商推广活动API
获取推广链接API
优惠券推广API
机构推客API
店铺API
异常码自查工具
suning.netalliance.searchcommodity.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天支出佣金金额由高到低。
picWidthStringN800图片宽度 默认800
picHeightStringN800图片高度 默认800
sizeStringN10每页条数 默认10,最大支持40
branchStringN11:减枝 2:不减枝 sortType=1(综合) 默认不剪枝 其他排序默认剪枝
snfwserviceStringN1是否苏宁服务 1:是
snhwgStringN1是否苏宁国际 1:是
couponStringN11:有券;其他:全部
couponMarkStringN11表示拿到券后价,不传按照以前逻辑取不到券后价
响应参数
名称 类型 示例值 描述
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:本地暂不销售
productUrlStringhttps://product.suning.com/供应商编码/商品编码.html四级页地址
forbiddenMarkString11:禁售 0:非禁售
isActString10不是 1是
pgInfoString
pgNumString2成团人数
pgPriceString20.00拼购价
pgUrlStringhttps://pin.suning.com/pgs/product/45918238111498247256.html拼购四级页地址
pgActionIdString45918238111498247256拼购活动ID
minOrderQuantityString1拼购商品起售数量
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元活动描述
afterCouponPriceString60.00券后价
preferentialDistinctString12奖励优惠说明
couponShowTypeString1券标识类型,1.金额券 2,打折券
descriptionForListString1列表页券描述
bounsAmountString1奖励数值(券面额)
advanceSaleString
isReserveCommodityString1是否预售 1:是 0:否
depositAmountString200定金
depositEndTimeString2017-10-10 10:00:00付定金结束时间
orderActivityString
activityRuleListString
floorString1层级
baseAmountString2基数数值
rewardAmountString0.2奖励数值
activityDescriptionString满2件打8折奖励描述
goodsCountString10商品总数
pageCountString1总页数
cmmdtyReviewInfoString
totalReviewCountString123评价总数
goodReviewCountString12好评数量
goodRateString12好评率
parametersListString
parameterCodeString2参数代码
parameterSequenceString1参数排序码
parameterDescString1参数描述
parameterValString1参数描述值
parametersCodeString1参数组代码
parametersDescString1参数组描述
sequenceString1参数组排序
explainString说明参数说明文
coreFlagString1核心参数
couponInfoListString
startTimeString20210609 11:22:123开始时间
activityIdString1243活动id
couponStartTimeString20210609 11:22:123券开始时间
bounsLimitString1123
activityDescriptionString123活动描述
couponEndTimeString2021-06-09 11:12:123券结束时间
couponCountString1001000
couponValueString1212
endTimeString2021-06-09 11:22:123结束时间
activitySecretKeyString1234567密钥
couponUrlString123123
subCodeListString
subCodeString123子码
actListString
activityDescriptionString123活动描述
actRoleListString
floorString1
baseAmountString1123
rewardAmountString1123
arrivalPriceString123到手价
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <querySearchcommodity>
      <picWidth>800</picWidth>
      <startPrice>10.00</startPrice>
      <couponMark>1</couponMark>
      <picHeight>800</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>
    </querySearchcommodity>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "querySearchcommodity": {
        "picWidth": "800",
        "startPrice": "10.00",
        "couponMark": "1",
        "picHeight": "800",
        "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_body>
    <querySearchcommodity>
      <advanceSale>
        <depositAmount>200</depositAmount>
        <depositEndTime>2017-10-10 10:00:00</depositEndTime>
        <isReserveCommodity>1</isReserveCommodity>
      </advanceSale>
      <pageCount>1</pageCount>
      <actList>
        <actRoleList>
          <rewardAmount>1</rewardAmount>
          <floor>1</floor>
          <baseAmount>1</baseAmount>
        </actRoleList>
        <activityDescription>123</activityDescription>
      </actList>
      <couponInfo>
        <activitySecretKey>mzekhfSGwaRrZIopV0M1wGRM</activitySecretKey>
        <couponShowType>1</couponShowType>
        <afterCouponPrice>60.00</afterCouponPrice>
        <couponCount>100</couponCount>
        <couponUrl>https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&amp;activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM</couponUrl>
        <couponValue>10.00</couponValue>
        <bounsLimit>15.00</bounsLimit>
        <couponEndTime>2019-07-04 17:10:47</couponEndTime>
        <activityId>201907040010040371</activityId>
        <preferentialDistinct>12</preferentialDistinct>
        <couponStartTime>2019-07-04 17:10:47</couponStartTime>
        <descriptionForList>1</descriptionForList>
        <startTime>2019-07-04 17:10:47</startTime>
        <activityDescription>免费领取送券10元</activityDescription>
        <endTime>2019-07-04 17:10:47</endTime>
        <bounsAmount>1</bounsAmount>
      </couponInfo>
      <orderActivity>
        <activityRuleList>
          <rewardAmount>0.2</rewardAmount>
          <floor>1</floor>
          <baseAmount>2</baseAmount>
        </activityRuleList>
        <activityDescription>满2件打8折</activityDescription>
      </orderActivity>
      <pgInfo>
        <pgUrl>https://pin.suning.com/pgs/product/45918238111498247256.html</pgUrl>
        <pgActionId>45918238111498247256</pgActionId>
        <pgNum>2</pgNum>
        <minOrderQuantity>1</minOrderQuantity>
        <pgPrice>20.00</pgPrice>
      </pgInfo>
      <arrivalPrice>123</arrivalPrice>
      <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>
      <goodsCount>10</goodsCount>
      <subCodeList>
        <subCode>123</subCode>
      </subCodeList>
      <couponInfoList>
        <activitySecretKey>1234567</activitySecretKey>
        <bounsLimit>1</bounsLimit>
        <couponEndTime>2021-06-09 11:12:123</couponEndTime>
        <activityId>1243</activityId>
        <couponStartTime>20210609 11:22:123</couponStartTime>
        <couponCount>100</couponCount>
        <couponUrl>123</couponUrl>
        <startTime>20210609 11:22:123</startTime>
        <activityDescription>123</activityDescription>
        <endTime>2021-06-09 11:22:123</endTime>
        <couponValue>12</couponValue>
      </couponInfoList>
      <parametersList>
        <explain>说明</explain>
        <parameterDesc>1</parameterDesc>
        <sequence>1</sequence>
        <parameterVal>1</parameterVal>
        <parametersCode>1</parametersCode>
        <parameterSequence>1</parameterSequence>
        <coreFlag>1</coreFlag>
        <parametersDesc>1</parametersDesc>
        <parameterCode>2</parameterCode>
      </parametersList>
      <cmmdtyReviewInfo>
        <goodRate>12</goodRate>
        <goodReviewCount>12</goodReviewCount>
        <totalReviewCount>123</totalReviewCount>
      </cmmdtyReviewInfo>
      <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>
        <forbiddenMark>1</forbiddenMark>
        <isAct>1</isAct>
        <priceTypeCode>1</priceTypeCode>
        <rate>20.00</rate>
        <commodityCode>761137021</commodityCode>
        <productUrl>https://product.suning.com/供应商编码/商品编码.html</productUrl>
        <commodityName>商品名称示例</commodityName>
      </commodityInfo>
    </querySearchcommodity>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "querySearchcommodity": {
        "advanceSale": [
          {
            "depositAmount": "200",
            "depositEndTime": "2017-10-10 10:00:00",
            "isReserveCommodity": "1"
          }
        ],
        "pageCount": "1",
        "actList": [
          {
            "actRoleList": [
              {
                "rewardAmount": "1",
                "floor": "1",
                "baseAmount": "1"
              }
            ],
            "activityDescription": "123"
          }
        ],
        "couponInfo": [
          {
            "activitySecretKey": "mzekhfSGwaRrZIopV0M1wGRM",
            "couponShowType": "1",
            "afterCouponPrice": "60.00",
            "couponCount": "100",
            "couponUrl": "https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM",
            "couponValue": "10.00",
            "bounsLimit": "15.00",
            "couponEndTime": "2019-07-04 17:10:47",
            "activityId": "201907040010040371",
            "preferentialDistinct": "12",
            "couponStartTime": "2019-07-04 17:10:47",
            "descriptionForList": "1",
            "startTime": "2019-07-04 17:10:47",
            "activityDescription": "免费领取送券10元",
            "endTime": "2019-07-04 17:10:47",
            "bounsAmount": "1"
          }
        ],
        "orderActivity": [
          {
            "activityRuleList": [
              {
                "rewardAmount": "0.2",
                "floor": "1",
                "baseAmount": "2"
              }
            ],
            "activityDescription": "满2件打8折"
          }
        ],
        "pgInfo": [
          {
            "pgUrl": "https://pin.suning.com/pgs/product/45918238111498247256.html",
            "pgActionId": "45918238111498247256",
            "pgNum": "2",
            "minOrderQuantity": "1",
            "pgPrice": "20.00"
          }
        ],
        "arrivalPrice": "123",
        "categoryInfo": [
          {
            "firstPurchaseCategoryId": "R001",
            "secondPurchaseCategoryId": "R002",
            "goodsGroupCategoryId": "R9001213",
            "firstPurchaseCategoryName": "一级采购目录名称示例",
            "thirdSaleCategoryId": "50000",
            "secondSaleCategoryId": "50000",
            "secondSaleCategoryName": "二级销售目录名称示例",
            "goodsGroupCategoryName": "商品组目录名称示例",
            "firstSaleCategoryId": "50000",
            "thirdPurchaseCategoryId": "R003",
            "firstSaleCategoryName": "一级销售目录名称示例",
            "thirdSaleCategoryName": "三级销售目录名称示例",
            "thirdPurchaseCategoryName": "三级采购目录名称示例",
            "secondPurchaseCategoryName": "二级采购目录名称示例"
          }
        ],
        "goodsCount": "10",
        "subCodeList": [
          {
            "subCode": "123"
          }
        ],
        "couponInfoList": [
          {
            "activitySecretKey": "1234567",
            "bounsLimit": "1",
            "couponEndTime": "2021-06-09 11:12:123",
            "activityId": "1243",
            "couponStartTime": "20210609 11:22:123",
            "couponCount": "100",
            "couponUrl": "123",
            "startTime": "20210609 11:22:123",
            "activityDescription": "123",
            "endTime": "2021-06-09 11:22:123",
            "couponValue": "12"
          }
        ],
        "parametersList": {
          "explain": "说明",
          "parameterDesc": "1",
          "sequence": "1",
          "parameterVal": "1",
          "parametersCode": "1",
          "parameterSequence": "1",
          "coreFlag": "1",
          "parametersDesc": "1",
          "parameterCode": "2"
        },
        "cmmdtyReviewInfo": [
          {
            "goodRate": "12",
            "goodReviewCount": "12",
            "totalReviewCount": "123"
          }
        ],
        "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",
            "forbiddenMark": "1",
            "isAct": "1",
            "priceTypeCode": "1",
            "rate": "20.00",
            "commodityCode": "761137021",
            "productUrl": "https://product.suning.com/供应商编码/商品编码.html",
            "commodityName": "商品名称示例"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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