API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.queryhourranklist.query 查询关键词过去一小时排名数据
¥免费

查询关键词过去一小时排名数据

公共参数
请求参数
名称 类型 是否必须 示例值 描述
quaityScoreListStringN
keywordStringY40000081关键字
keywordIdStringY40000008关键词ID
响应参数
名称 类型 示例值 描述
statusString0:成功,1:失败状态
msgString成功状态说明
dataString
keywordIdString关键词ID关键词ID
pcRankNumString电脑端排名电脑端排名
appRankNumStringapp端排名app端排名
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryQueryhourranklist>
      <quaityScoreList>
        <keywordId>40000008</keywordId>
        <keyword>40000081</keyword>
      </quaityScoreList>
    </queryQueryhourranklist>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryQueryhourranklist": {
        "quaityScoreList": [
          {
            "keywordId": "40000008",
            "keyword": "40000081"
          }
        ]
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryQueryhourranklist>
      <msg>成功</msg>
      <data>
        <keywordId>关键词ID</keywordId>
        <appRankNum>app端排名</appRankNum>
        <pcRankNum>电脑端排名</pcRankNum>
      </data>
      <status>0:成功,1:失败</status>
    </queryQueryhourranklist>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryQueryhourranklist": {
        "msg": "成功",
        "data": [
          {
            "keywordId": "关键词ID",
            "appRankNum": "app端排名",
            "pcRankNum": "电脑端排名"
          }
        ],
        "status": "0:成功,1:失败"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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