淘宝商品详情查询
<h3>接口描述</h3>
<ul>
<li>淘宝天猫商品详细信息查询，可应用于商品销售情况分析，电商选品分析，品牌口碑挖掘和竞争对手分析等</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/taobao/goods/detail</code></p>
<h3>请求方式</h3>
<ul>
<li>GET/POST</li>
</ul>
<h3>请求格式</h3>
<ul>
<li>x-www-form-urlencoded</li>
</ul>
<h3>请求参数</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>appId</td>
<td>String</td>
<td>是</td>
<td>服务商分配的唯一标识</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>是</td>
<td>当前时间的毫秒数</td>
</tr>
<tr>
<td>sign</td>
<td>String</td>
<td>是</td>
<td>签名，见签名算法说明</td>
</tr>
<tr>
<td>goodsId</td>
<td>String</td>
<td>是</td>
<td>商品ID</td>
</tr>
</tbody>
</table>
<h3>签名算法说明</h3>
<pre><code>sign = sha256( appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 appId、服务商分配的 appSecret，当前时间毫秒数 timestamp，按上述顺序拼接成字符串，再进行 sha256 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h3>正确返回样例</h3>
<pre><code class="language-json">// 查得
{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;54371164422457659809&quot;,
&quot;charge&quot;: true,
&quot;data&quot;: {
&quot;seller&quot;: {
&quot;newItemCount&quot;: &quot;6&quot;,
&quot;shopCard&quot;: &quot;掌柜近期上新6件宝贝，速览&quot;,
&quot;shopName&quot;: &quot;中国移动和包官方旗舰店&quot;,
&quot;evaluates&quot;: [
{
&quot;score&quot;: &quot;4.8 &quot;,
&quot;tmallLevelTextColor&quot;: &quot;#FF0036&quot;,
&quot;level&quot;: &quot;1&quot;,
&quot;levelText&quot;: &quot;高&quot;,
&quot;levelBackgroundColor&quot;: &quot;#FFF1EB&quot;,
&quot;title&quot;: &quot;宝贝描述&quot;,
&quot;tmallLevelBackgroundColor&quot;: &quot;#FFF1EB&quot;,
&quot;type&quot;: &quot;desc&quot;
},
{
&quot;score&quot;: &quot;4.8 &quot;,
&quot;tmallLevelTextColor&quot;: &quot;#FF0036&quot;,
&quot;level&quot;: &quot;0&quot;,
&quot;levelText&quot;: &quot;平&quot;,
&quot;levelBackgroundColor&quot;: &quot;#EEEEEE&quot;,
&quot;title&quot;: &quot;卖家服务&quot;,
&quot;tmallLevelBackgroundColor&quot;: &quot;#FFF1EB&quot;,
&quot;type&quot;: &quot;serv&quot;
},
{
&quot;score&quot;: &quot;4.8 &quot;,
&quot;tmallLevelTextColor&quot;: &quot;#FF0036&quot;,
&quot;level&quot;: &quot;0&quot;,
&quot;levelText&quot;: &quot;平&quot;,
&quot;levelBackgroundColor&quot;: &quot;#EEEEEE&quot;,
&quot;title&quot;: &quot;物流服务&quot;,
&quot;tmallLevelBackgroundColor&quot;: &quot;#FFF1EB&quot;,
&quot;type&quot;: &quot;post&quot;
}
],
&quot;entranceList&quot;: [
{
&quot;backgroundColor&quot;: &quot;#59000000&quot;,
&quot;borderColor&quot;: &quot;#59ffffff&quot;,
&quot;action&quot;: [
{
&quot;params&quot;: {
&quot;url&quot;: &quot;//shop.m.taobao.com/shop/shop_index.htm?user_id=2200784241956&amp;item_id=591655048964&amp;currentClickTime=-1&quot;
},
&quot;key&quot;: &quot;open_url&quot;
},
{
&quot;params&quot;: {
&quot;trackParams&quot;: {
&quot;spm&quot;: &quot;a.2141.7631564.shoppage&quot;
},
&quot;trackName&quot;: &quot;Button-NewShopcard-ShopPage&quot;
},
&quot;key&quot;: &quot;user_track&quot;
}
],
&quot;text&quot;: &quot;进店逛逛&quot;,
&quot;textColor&quot;: &quot;#ffffff&quot;
},
{
&quot;backgroundColor&quot;: &quot;#59000000&quot;,
&quot;borderColor&quot;: &quot;#59ffffff&quot;,
&quot;action&quot;: [
{
&quot;params&quot;: {
&quot;url&quot;: &quot;//shop.m.taobao.com/shop/shop_index.htm?user_id=2200784241956&amp;item_id=591655048964&amp;shop_navi=allitems&quot;
},
&quot;key&quot;: &quot;open_url&quot;
},
{
&quot;params&quot;: {
&quot;trackParams&quot;: {
&quot;spm&quot;: &quot;a.2141.7631564.allitem&quot;
},
&quot;trackName&quot;: &quot;Button-NewShopcard-AllItem&quot;
},
&quot;key&quot;: &quot;user_track&quot;
}
],
&quot;text&quot;: &quot;全部宝贝&quot;,
&quot;textColor&quot;: &quot;#ffffff&quot;
}
],
&quot;showShopLinkIcon&quot;: &quot;false&quot;,
&quot;simpleShopDOStatus&quot;: &quot;1&quot;,
&quot;fbt2User&quot;: &quot;中国移动和包官方旗舰店&quot;,
&quot;creditLevel&quot;: &quot;20&quot;,
&quot;taoShopUrl&quot;: &quot;//shop.m.taobao.com/shop/shop_index.htm?user_id=2200784241956&amp;item_id=591655048964&quot;,
&quot;sellerId&quot;: &quot;2200784241956&quot;,
&quot;atmosphereMaskColor&quot;: &quot;#59000000&quot;,
&quot;evaluates2&quot;: [
{
&quot;score&quot;: &quot;4.8 &quot;,
&quot;titleColor&quot;: &quot;#ffffff&quot;,
&quot;level&quot;: &quot;1&quot;,
&quot;levelText&quot;: &quot;高&quot;,
&quot;scoreTextColor&quot;: &quot;#ffffff&quot;,
&quot;levelTextColor&quot;: &quot;#f0f0f0&quot;,
&quot;title&quot;: &quot;宝贝描述&quot;,
&quot;type&quot;: &quot;desc&quot;
},
{
&quot;score&quot;: &quot;4.8 &quot;,
&quot;titleColor&quot;: &quot;#ffffff&quot;,
&quot;level&quot;: &quot;0&quot;,
&quot;levelText&quot;: &quot;平&quot;,
&quot;scoreTextColor&quot;: &quot;#ffffff&quot;,
&quot;levelTextColor&quot;: &quot;#f0f0f0&quot;,
&quot;title&quot;: &quot;卖家服务&quot;,
&quot;type&quot;: &quot;serv&quot;
},
{
&quot;score&quot;: &quot;4.8 &quot;,
&quot;titleColor&quot;: &quot;#ffffff&quot;,
&quot;level&quot;: &quot;0&quot;,
&quot;levelText&quot;: &quot;平&quot;,
&quot;scoreTextColor&quot;: &quot;#ffffff&quot;,
&quot;levelTextColor&quot;: &quot;#f0f0f0&quot;,
&quot;title&quot;: &quot;物流服务&quot;,
&quot;type&quot;: &quot;post&quot;
}
],
&quot;pcShopUrl&quot;: &quot;//shop190221868.taobao.com&quot;,
&quot;allItemCount&quot;: &quot;186&quot;,
&quot;creditLevelIcon&quot;: &quot;//gw.alicdn.com/tfs/TB1QoJUIwmTBuNjy1XbXXaMrVXa-84-36.png?getAvatar=avatar&quot;,
&quot;atmosphereColor&quot;: &quot;#ffffff&quot;,
&quot;shopId&quot;: &quot;190221868&quot;,
&quot;goodRatePercentage&quot;: &quot;100.00%&quot;,
&quot;sellerNick&quot;: &quot;中国移动和包官方旗舰店&quot;,
&quot;shopIcon&quot;: &quot;//img.alicdn.com/imgextra//i3/2200784241956/O1CN012xH4Ad1QJtFUoDvng_!!2200784241956.png&quot;,
&quot;shopUrl&quot;: &quot;tmall://page.tm/shop?item_id=591655048964&amp;shopId=190221868&quot;,
&quot;userId&quot;: &quot;2200784241956&quot;,
&quot;shopVersion&quot;: &quot;0&quot;,
&quot;atmophereMask&quot;: &quot;true&quot;,
&quot;fans&quot;: &quot;13.3万&quot;,
&quot;atmosphereImg&quot;: &quot;https://img.alicdn.com/imgextra/i2/2200784241956/O1CN017KIHb81QJtFSZGhVf_!!2200784241956.jpg&quot;,
&quot;shopType&quot;: &quot;B&quot;,
&quot;sellerType&quot;: &quot;B&quot;,
&quot;shopTextColor&quot;: &quot;#ffffff&quot;
},
&quot;delivery&quot;: {
&quot;deliveryToAddr&quot;: &quot;厦门市 思明区&quot;,
&quot;freight&quot;: &quot;快递: 免运费&quot;,
&quot;deliveryFromAddr&quot;: &quot;湖南长沙&quot;
},
&quot;item&quot;: {
&quot;images&quot;: [
&quot;//img.alicdn.com/imgextra/i1/2200784241956/O1CN010rgWPI1QJtQwI9y8W_!!2-item_pic.png&quot;
],
&quot;tmallDescUrl&quot;: &quot;//mdetail.tmall.com/templates/pages/desc?id=591655048964&quot;,
&quot;favcount&quot;: &quot;46&quot;,
&quot;cartUrl&quot;: &quot;https://h5.m.taobao.com/awp/base/cart.htm&quot;,
&quot;countMultiple&quot;: [],
&quot;h5ItemUrl&quot;: &quot;https://new.m.taobao.com/detail.htm?id=591655048964&amp;hybrid=true&quot;,
&quot;exParams&quot;: {},
&quot;title&quot;: &quot;浙江移动 手机 话费充值 200元 快充直充 24小时自动充值快速到账&quot;,
&quot;openDecoration&quot;: &quot;false&quot;,
&quot;commentCount&quot;: &quot;0&quot;,
&quot;rootCategoryId&quot;: &quot;50004958&quot;,
&quot;itemId&quot;: &quot;591655048964&quot;,
&quot;useWirelessDesc&quot;: &quot;true&quot;,
&quot;subtitle&quot;: &quot;&quot;,
&quot;pcADescUrl&quot;: &quot;//market.m.taobao.com/app/detail-project/desc/index.html?id=591655048964&amp;descVersion=7.0&amp;type=1&amp;f=icoss!0591655048964!12020409093&amp;sellerType=B&quot;,
&quot;spuId&quot;: &quot;140892&quot;,
&quot;taobaoDescUrl&quot;: &quot;//market.m.taobao.com/app/detail-project/desc/index.html?id=591655048964&amp;descVersion=6.0&amp;type=1&amp;f=icoss!0591655048964!12020409093&amp;sellerType=B&quot;,
&quot;titleIcon&quot;: &quot;//img.alicdn.com/tfs/TB1SMG7nnvI8KJjSspjXXcgjXXa-78-36.png?getAvatar=avatar&quot;,
&quot;taobaoPcDescUrl&quot;: &quot;//market.m.taobao.com/app/detail-project/desc/index.html?id=591655048964&amp;descVersion=6.0&amp;type=1&amp;f=icoss!0591655048964!12020409093&amp;sellerType=B&quot;,
&quot;categoryId&quot;: &quot;150401&quot;
},
&quot;skuCore&quot;: {
&quot;skuItem&quot;: {
&quot;renderSku&quot;: &quot;false&quot;,
&quot;itemStatus&quot;: &quot;0&quot;,
&quot;unitBuy&quot;: &quot;1&quot;
},
&quot;sku2info&quot;: {
&quot;0&quot;: {
&quot;moreQuantity&quot;: &quot;false&quot;,
&quot;quantity&quot;: &quot;99&quot;,
&quot;price&quot;: {
&quot;priceText&quot;: &quot;200&quot;,
&quot;priceMoney&quot;: &quot;20000&quot;
},
&quot;quantityText&quot;: &quot;有货&quot;
}
}
},
&quot;services&quot;: [
&quot;假一赔四&quot;
],
&quot;video&quot;: [],
&quot;params&quot;: {
&quot;trackParams&quot;: {
&quot;detailabtestdetail&quot;: &quot;&quot;
},
&quot;aplusParams&quot;: &quot;[]&quot;
},
&quot;apiStack&quot;: [
{
&quot;result&quot;: {},
&quot;crawl_time&quot;: &quot;2023-03-07 10:41:26&quot;,
&quot;name&quot;: &quot;esi&quot;,
&quot;state&quot;: &quot;上架&quot;,
&quot;type&quot;: &quot;pc detail app&quot;
}
],
&quot;pcTrade&quot;: {
&quot;buyNowUrl&quot;: &quot;//buy.taobao.com/auction/buy_now.jhtml&quot;,
&quot;pcCartParam&quot;: {
&quot;areaId&quot;: &quot;350203&quot;
},
&quot;pcBuyParams&quot;: {
&quot;virtual&quot;: &quot;true&quot;,
&quot;buy_now&quot;: &quot;200.00&quot;,
&quot;auction_type&quot;: &quot;b&quot;,
&quot;x-uid&quot;: &quot;&quot;,
&quot;title&quot;: &quot;浙江移动 手机 话费充值 200元 快充直充 24小时自动充值快速到账&quot;,
&quot;buyer_from&quot;: &quot;ecity&quot;,
&quot;detailIsLimit&quot;: &quot;false&quot;,
&quot;who_pay_ship&quot;: &quot;卖家承担运费&quot;,
&quot;rootCatId&quot;: &quot;50004958&quot;,
&quot;auto_post1&quot;: &quot;150401-*-*-phone&quot;,
&quot;auto_post&quot;: &quot;false&quot;,
&quot;seller_nickname&quot;: &quot;中国移动和包官方旗舰店&quot;,
&quot;photo_url&quot;: &quot;i1/2200784241956/O1CN010rgWPI1QJtQwI9y8W_!!2-item_pic.png&quot;,
&quot;current_price&quot;: &quot;200.00&quot;,
&quot;region&quot;: &quot;湖南长沙&quot;,
&quot;seller_id&quot;: &quot;05bde5020083ce4bb3aacc0966bf9c85&quot;,
&quot;etm&quot;: &quot;post&quot;
},
&quot;tradeType&quot;: &quot;1&quot;
},
&quot;props&quot;: {
&quot;groupProps&quot;: [
{
&quot;基本信息&quot;: [
{
&quot;面值&quot;: &quot;200元&quot;
},
{
&quot;地区&quot;: &quot;浙江&quot;
},
{
&quot;充值方式&quot;: &quot;自动充值&quot;
}
]
}
]
},
&quot;mockData&quot;: &quot;{\&quot;delivery\&quot;:{},\&quot;trade\&quot;:{\&quot;buyEnable\&quot;:true,\&quot;cartEnable\&quot;:true},\&quot;feature\&quot;:{},\&quot;price\&quot;:{\&quot;price\&quot;:{\&quot;priceText\&quot;:\&quot;200.00\&quot;}},\&quot;skuCore\&quot;:{\&quot;sku2info\&quot;:{\&quot;0\&quot;:{\&quot;price\&quot;:{\&quot;priceMoney\&quot;:20000,\&quot;priceText\&quot;:\&quot;200.00\&quot;,\&quot;priceTitle\&quot;:\&quot;价格\&quot;},\&quot;quantity\&quot;:100}},\&quot;skuItem\&quot;:{\&quot;hideQuantity\&quot;:true}}}&quot;,
&quot;feature&quot;: {
&quot;tmwOverseasScene&quot;: &quot;false&quot;
},
&quot;price&quot;: {
&quot;price&quot;: {
&quot;priceUnit&quot;: &quot;￥&quot;,
&quot;priceColor&quot;: &quot;#FF4F00&quot;,
&quot;priceTitleColor&quot;: &quot;#FF4F00&quot;,
&quot;priceText&quot;: &quot;200&quot;,
&quot;priceMoney&quot;: &quot;20000&quot;,
&quot;hiddenPrice&quot;: &quot;false&quot;
}
},
&quot;skuBase&quot;: {
&quot;components&quot;: [],
&quot;skus&quot;: []
}
}
}
// 查无
{
&quot;msg&quot;: &quot;未查询到商品信息&quot;,
&quot;code&quot;: 201,
&quot;taskNo&quot;: &quot;91022205788462492535&quot;,
&quot;charge&quot;: true,
}</code></pre>
<h3>错误返回样例</h3>
<pre><code class="language-json">{
&quot;code&quot;: 400,
&quot;msg&quot;: &quot;商品id不能为空&quot;,
&quot;charge&quot;: false
}</code></pre>
<h3>返回字段说明</h3>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见：code返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，object类型，详见data返回字段描述</td>
</tr>
</tbody>
</table>
<h4>code返回码说明</h4>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功（计费）</td>
</tr>
<tr>
<td>201</td>
<td>未查询到商品信息（计费）</td>
</tr>
<tr>
<td>400</td>
<td>参数错误</td>
</tr>
<tr>
<td>404</td>
<td>接口地址不正确</td>
</tr>
<tr>
<td>500</td>
<td>系统维护，请稍候再试</td>
</tr>
<tr>
<td>601</td>
<td>接口未开通</td>
</tr>
<tr>
<td>602</td>
<td>账号停用</td>
</tr>
<tr>
<td>603</td>
<td>余额不足请充值</td>
</tr>
<tr>
<td>604</td>
<td>接口停用</td>
</tr>
<tr>
<td>606</td>
<td>调用超限，请稍候再试</td>
</tr>
<tr>
<td>609</td>
<td>请求过于频繁，请稍候再试</td>
</tr>
<tr>
<td>610</td>
<td>请求超时</td>
</tr>
<tr>
<td>999</td>
<td>其他，以实际返回为准</td>
</tr>
</tbody>
</table>