首页 服务与支持

单个商品查询

接口状态:正常

数据类型:电子商务

收费标准:19元 /千次

概述:提供主流电商平台(天猫、京东、当当、一号店、苏宁)商品的线上数据表现(品类、品牌、产品名、价格、销量等),实时返回数据。

联系方式:

API 示例代码

通过关键词(商品id和商品所属平台标识id), 搜索五大电商商品信息

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

数据提交方式:POST

提交的数据格式:json

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

系统级别输入参数

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

应用级别输入参数

名称 类型 是否必须 描述
SiteId Number 可选 电商平台标识id,枚举值为:1、京东 3、天猫 4、一号店 6、苏宁易购 10、当当网
ItemId Number 商品id,不允许为空
TimeStamp Number unix时间戳,例如:1433473473. API服务端允许客户端请求时间误差为10分钟.

返回结果

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

对象说明

ProductItem 商品信息
名称 类型 示例值 描述
ProductId Number 1 商品标识Id
Title String 苹果(Apple)iPhone 6 (A1586) 16GB 金色 移动联通电信4G手机 商品标题
Price Number 4699.00 商品价格
DetailUrl String http://detail.tmall.com/item.htm?id=44042410655 商品详情链接地址
ImgUrl String http://m.360buyimg.com/n0/jfs/t277/193/1005339798 /768456/29136988/542d0798N19d42ce3.jpg!q70.jpg 商品图片地址
SaleNum Number 10 商品销量
GoodRateCount Number 100 好评总数
NormalRateCount Number 100 中评总数
BadRateCount Number 100 差评总数
Skus String [{"Model":null,"Price":null,"SkuId":"1217499","SkuName":"非合约机"},{"Model":null,"Price":null,"SkuId":"1219296","SkuName":"购机入网送话费"},{"Model":null,"Price":null,"SkuId":"1324588","SkuName":"北京移动购机赠费"},{"Model":null,"Price":null,"SkuId":"1558078","SkuName":"0元购机"}] 商品SKU
Platform String JD 商品所属电商平台

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.   }  
订阅了解我们最新的数据简报及市场资讯

联系我们