首页 服务与支持

商品信息查询

接口状态:正常

数据类型:电子商务

收费标准:免费

概述:提供主流电商平台(天猫、京东、当当、一号店、苏宁)商品的线上历史数据信息(品类、品牌、产品名、价格、销量等)。

联系方式:

API 示例代码

通过关键词(产品名称、产品品牌、产品型号),搜索商品信息

APIUrl地址:http://doc.simplybrand.com/QueryProduct.html

数据提交方式:POST

提交的数据格式:json

Header的Content-type类型均为application/json

系统级别输入参数

HTTP签名调用方式
名称 类型 是否必须 描述
Appkey String TOP分配给应用的AppKey
Sign String API 应用级输入参数 签名结果 查看生成sign方法

应用级别输入参数

名称 类型 是否必须 描述
Keyword String 搜索关键词,不允许为空
TimeStamp Number unix时间戳,例如:1433473473. API服务端允许客户端请求时间误差为10分钟.
SiteId Number 可选 电商平台标识id,枚举值为:1、京东 2、淘宝 3、天猫 4、一号店 5、易迅网 6、苏宁易购 7、国美 8、新蛋 9、 亚马逊
PageIndex Number 可选 页码.传入值为1代表第一页,传入值为2代表第二页,依此类推.默认返回的数据是从第一页开始.
PageSize Number 可选 每页条数.每页返回最多返回100条,默认值为40.

返回结果

名称 类型 是否必须 示例值 描述
ResponseResult ProductItem [] 查看 商品信息
ResponseStatus String Succ 接口调用状态信息,Succ 成功,Fail 失败
TotalResults Number 10 结果总数
ErrorMsg ErrorMsg [] 查看 ResponseStatus值为 Fail 时,返回的错误信息

对象说明

ProductItem 商品信息
名称 类型 示例值 描述
ProductId Number 1 商品标识Id
Title String 苹果手机iphone 6 商品标题
Price Number 10.00 商品价格
DetailUrl String http://host/1295318.html 商品详情链接地址
ImgUrl String http://host/image_path 商品图片url地址
SellNum Number 10 结果总数
Platform String Tmall 商品所属电商平台

ErrorMsg 错误信息

名称 类型 示例值 描述
Code Number 10000 错误代码
Message String 关键词不能为空 错误信息

生成签名Sign

  1. private string generateSign(Dictionary<string,string> dicParam,string appKey,string appSecret)  
  2.   {  
  3.         //按key(参数名称)进行排序  
  4.        dicParam = dicParam.OrderBy(o => o.Key).ToDictionary(o => o.Key, t => t.Value);  
  5.   
  6.        StringBuilder builder = new StringBuilder();  
  7.   
  8.        builder.Append(appKey);  
  9.   
  10.       foreach (var item in dicParam)  
  11.       {  
  12.           builder.Append(item.Value);  
  13.       }  
  14.   
  15.       builder.Append(appSecret);  
  16.   
  17.       //生成32位Md5加密字符串  
  18.       return Md5Encry(builder.ToString());  
  19.   }  
订阅了解我们最新的数据简报及市场资讯

联系我们