API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.querysmartkeyword.query 查询智能词包
¥增值

查询智能词包

公共参数
请求参数
名称 类型 是否必须 示例值 描述
keywordStringN
custnumStringY6001849930操作用户id
orderByStringN排序字段
pagerSizeStringN10每页大小
pageNumStringN1页数
nameStringN关键词名
promotionUnitIdStringN40000008单元ID
startDateStringY2020-05-22查询开始日期
endDateStringY2020-05-22查询结束日期
promotionIdStringN40000008计划ID
promotionTypeStringY2计划类型
unitStatusStringN1单元状态
promotionStatusStringN1计划状态
响应参数
名称 类型 示例值 描述
statusString1状态
msgString状态说明
dataString
allDealAmountString0总成交金额
allDealOrderString0总成交订单数
allSubmitAmountString0总提交金额
allSubmitOrderString0总提交订单数
budgetString0日预算
clickNumString0点击量
clickPercentString0点击率
dayCostString0日花费
dealROIString0成交ROI
endDateString结束日期
goodsString
goodsCodeString商品编码
linkUrlString商品着陆页URL
goodsImgString商品图片
wapLinkUrlStringwap商品着陆页URL
isActiveString是否删除
isHotString0是否参与热卖页售卖
keywordIdString关键词id
nameString智能关键词包智能词包名称
ocpcStringocpc
offsetString0offset
orderByString排序字段
pageCodeString类目ID
pageNumString1当前页数
pcPriceStringpc端价格
promotionIdString计划ID
promotionNameString计划名称
promotionStatusString计划状态
promotionTypeString计划类型
promotionUnitIdString单元id
qualityScoreString10质量得分
showNumString0展示量
startDateString开始日期
statusString0状态(无效返回)
submitROIString0提交ROI
typeString2关键词类型
unitNameString单元名称
unitStatusString0单元状态
userIdString查询用户ID
wapPriceStringwap端价格
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryQuerysmartkeyword>
      <keyword>
        <promotionUnitId>40000008</promotionUnitId>
        <promotionType>2</promotionType>
        <endDate>2020-05-22</endDate>
        <name>null</name>
        <orderBy>null</orderBy>
        <custnum>6001849930</custnum>
        <pageNum>1</pageNum>
        <startDate>2020-05-22</startDate>
        <promotionId>40000008</promotionId>
        <pagerSize>10</pagerSize>
        <unitStatus>1</unitStatus>
        <promotionStatus>1</promotionStatus>
      </keyword>
    </queryQuerysmartkeyword>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryQuerysmartkeyword": {
        "keyword": {
          "promotionUnitId": "40000008",
          "promotionType": "2",
          "endDate": "2020-05-22",
          "name": "null",
          "orderBy": "null",
          "custnum": "6001849930",
          "pageNum": "1",
          "startDate": "2020-05-22",
          "promotionId": "40000008",
          "pagerSize": "10",
          "unitStatus": "1",
          "promotionStatus": "1"
        }
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryQuerysmartkeyword>
      <msg>null</msg>
      <data>
        <allDealOrder>0</allDealOrder>
        <keywordId>null</keywordId>
        <allDealAmount>0</allDealAmount>
        <endDate>null</endDate>
        <orderBy>null</orderBy>
        <pageSize>10</pageSize>
        <goods>
          <goodsImg>null</goodsImg>
          <wapLinkUrl>null</wapLinkUrl>
          <linkUrl>null</linkUrl>
          <goodsCode>null</goodsCode>
        </goods>
        <isActive>null</isActive>
        <type>2</type>
        <promotionId>null</promotionId>
        <allSubmitOrder>0</allSubmitOrder>
        <promotionStatus>null</promotionStatus>
        <unitStatus>0</unitStatus>
        <pcPrice>null</pcPrice>
        <dealROI>0</dealROI>
        <promotionUnitId>null</promotionUnitId>
        <promotionName>null</promotionName>
        <submitROI>0</submitROI>
        <qualityScore>10</qualityScore>
        <clickNum>0</clickNum>
        <budget>0</budget>
        <wapPrice>null</wapPrice>
        <promotionType>null</promotionType>
        <offset>0</offset>
        <unitName>null</unitName>
        <pageNum>1</pageNum>
        <userId>null</userId>
        <pageCode>null</pageCode>
        <showNum>0</showNum>
        <ocpc>null</ocpc>
        <allSubmitAmount>0</allSubmitAmount>
        <dayCost>0</dayCost>
        <name>智能关键词包</name>
        <clickPercent>0</clickPercent>
        <isHot>0</isHot>
        <startDate>null</startDate>
        <status>0</status>
      </data>
      <status>1</status>
    </queryQuerysmartkeyword>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryQuerysmartkeyword": {
        "msg": "null",
        "data": [
          {
            "allDealOrder": "0",
            "keywordId": "null",
            "allDealAmount": "0",
            "endDate": "null",
            "orderBy": "null",
            "pageSize": "10",
            "goods": [
              {
                "goodsImg": "null",
                "wapLinkUrl": "null",
                "linkUrl": "null",
                "goodsCode": "null"
              }
            ],
            "isActive": "null",
            "type": "2",
            "promotionId": "null",
            "allSubmitOrder": "0",
            "promotionStatus": "null",
            "unitStatus": "0",
            "pcPrice": "null",
            "dealROI": "0",
            "promotionUnitId": "null",
            "promotionName": "null",
            "submitROI": "0",
            "qualityScore": "10",
            "clickNum": "0",
            "budget": "0",
            "wapPrice": "null",
            "promotionType": "null",
            "offset": "0",
            "unitName": "null",
            "pageNum": "1",
            "userId": "null",
            "pageCode": "null",
            "showNum": "0",
            "ocpc": "null",
            "allSubmitAmount": "0",
            "dayCost": "0",
            "name": "智能关键词包",
            "clickPercent": "0",
            "isHot": "0",
            "startDate": "null",
            "status": "0"
          }
        ],
        "status": "1"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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