淘宝商品评价详情查询(即将停止)
<h3>接口描述</h3>
<ul>
<li>淘宝商品评价详情查询V1,包括评价、追评等信息。可应用于商品销售情况分析,电商选品分析,品牌口碑挖掘和竞争对手分析等。</li>
</ul>
<h3>请求地址</h3>
<p><code>https://api.jumdata.com/taobao/goodsComment/query</code></p>
<h3>请求方式</h3>
<ul>
<li>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>
<tr>
<td>type</td>
<td>String</td>
<td>否</td>
<td>内容类型,all-全部,bad-差评,normal-中评,good-好评,append-追评,picture-图片,video-视频</td>
</tr>
<tr>
<td>pageNo</td>
<td>String</td>
<td>否</td>
<td>页码 默认1</td>
</tr>
<tr>
<td>sort</td>
<td>String</td>
<td>否</td>
<td>排序,1-推荐排序,2-时间排序,默认值:1</td>
</tr>
<tr>
<td>skuVids</td>
<td>String</td>
<td>否</td>
<td>sku评价筛选</td>
</tr>
<tr>
<td>expression</td>
<td>String</td>
<td>否</td>
<td>印象词评价筛选</td>
</tr>
</tbody>
</table>
<ul>
<li>skuVids评价筛选,商品sku的vid值。
例如,通过淘宝商品详细信息查询V2接口查询商品[525232305379]的返回skuBase->props字段结果如下:
{"values":[{"vid":"3232481","name":"黄色(三娃)"},{"vid":"90554","name":"橙色(二娃)"}],"name":"颜色分类","pid":"1627207"},
{"values":[{"vid":"28316","name":"9cm(现货)"}],"name":"大小","pid":"134942334"}
如需要查询所有颜色分类为[黄色(三娃)]和[橙色(二娃)]的评价,则入参值为 3232481,90554
如需要查询所有大小为[9cm(现货)]的评价,则入参值为 28316
如需要查询所有颜色分类为[黄色(三娃)]且大小为[9cm(现货)]的评价,则入参值为 3232481#28316</li>
<li>expression 印象词评价筛选
例如,通过淘宝商品详细信息查询V2接口查询商品[575965658008]的返回rate->keywords字段结果如下:
{"count":"24","attribute":"622-11","type":"1","word":"厚实"},
{"count":"15","attribute":"620-11","type":"1","word":"宝贝很赞"},
{"count":"13","attribute":"322-11","type":"1","word":"色彩很好"},
{"count":"8","attribute":"122-11","type":"1","word":"料子好"},
{"count":"8","attribute":"1822-11","type":"1","word":"穿上好看"},
{"count":"7","attribute":"922-11","type":"1","word":"做工好"}
如需要查询所有印象关键词为[厚实]的相关评价,则入参值为 622-11</li>
</ul>
<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;success&quot;: true,
&quot;taskNo&quot;: &quot;43291158134663130245&quot;,
&quot;charge&quot;: false,
&quot;data&quot;: {
&quot;feedVideoCount&quot;: &quot;0&quot;,
&quot;feedBadCount&quot;: &quot;0&quot;,
&quot;canReport&quot;: &quot;false&quot;,
&quot;range&quot;: &quot;100&quot;,
&quot;firstPageTips&quot;: &quot;淘宝鼓励真实有帮助的评价&quot;,
&quot;allowInteract&quot;: &quot;true&quot;,
&quot;latestSort&quot;: &quot;true&quot;,
&quot;fuzzyRateCount&quot;: &quot;100+&quot;,
&quot;total&quot;: &quot;32&quot;,
&quot;feedNotGoodCount&quot;: &quot;0&quot;,
&quot;feedAllCount&quot;: &quot;179&quot;,
&quot;feedStoreCount&quot;: &quot;0&quot;,
&quot;from&quot;: &quot;search-rp&quot;,
&quot;searchUrl&quot;: &quot;&quot;,
&quot;foldCount&quot;: &quot;147&quot;,
&quot;feedAppendCount&quot;: &quot;0&quot;,
&quot;feedNormalCount&quot;: &quot;0&quot;,
&quot;totalPage&quot;: &quot;2&quot;,
&quot;feedMediaCount&quot;: &quot;12&quot;,
&quot;showInvite&quot;: &quot;false&quot;,
&quot;feedPicCount&quot;: &quot;12&quot;,
&quot;rateList&quot;: [
{
&quot;headFrameUrl&quot;: &quot;http://wwc.alicdn.com/decoration/getDecoration.do?userIdStrV3=FVTJ0PfJTQTIAsANYj3wig%3D%3D&amp;namespace=taobao&amp;kn=wwc_review_user_head&quot;,
&quot;annoy&quot;: &quot;0&quot;,
&quot;repeatBusiness&quot;: &quot;false&quot;,
&quot;userIndexURL&quot;: &quot;&quot;,
&quot;own&quot;: &quot;false&quot;,
&quot;feedbackDate&quot;: &quot;2022-06-04&quot;,
&quot;allowInteract&quot;: &quot;true&quot;,
&quot;feedPicList&quot;: [
{
&quot;cover&quot;: &quot;false&quot;,
&quot;thumbnail&quot;: &quot;http://img.alicdn.com/imgextra/i2/0/O1CN01IDFWn823GTWURYkZL_!!0-tbbala.jpg&quot;,
&quot;fileId&quot;: &quot;1722807405387176359&quot;,
&quot;status&quot;: &quot;1&quot;
},
{
&quot;cover&quot;: &quot;false&quot;,
&quot;thumbnail&quot;: &quot;http://img.alicdn.com/imgextra/i1/0/O1CN01sxCruB23GTWVl5EVi_!!0-tbbala.jpg&quot;,
&quot;fileId&quot;: &quot;1722807406591801166&quot;,
&quot;status&quot;: &quot;1&quot;
},
{
&quot;cover&quot;: &quot;false&quot;,
&quot;thumbnail&quot;: &quot;http://img.alicdn.com/imgextra/i2/0/O1CN01bjMY1y23GTWYlZjUd_!!0-tbbala.jpg&quot;,
&quot;fileId&quot;: &quot;1722807409347468599&quot;,
&quot;status&quot;: &quot;1&quot;
}
],
&quot;structTagEndSize&quot;: &quot;40&quot;,
&quot;feedback&quot;: &quot;质感太赞啦,1百出头能买到简直惊喜到我,上身整个就是小仙女,小个子穿也是毫无压力 &quot;,
&quot;hasDetail&quot;: &quot;true&quot;,
&quot;rateType&quot;: &quot;1&quot;,
&quot;creditLevel&quot;: &quot;10&quot;,
&quot;headPicUrl&quot;: &quot;http://sns.cdn.taobao.com/avatar/sns/user/RAzN84GK7wS8eNdU2xjkPRdwEvGAUTNTyAYZCYUfSvbtG5EToBeoe5JtB3r8qu44jLCdLsayUhJeoTkmeAnbT6HZBmzR7FcxtuU9Wq3aZdwpKqeP9TwxgMP5RL5TrDQQfRuSSZ1QjLQLXyekVctUWdHTCNvRWCputndBp87/sns_logo?type=taobao&amp;kn=wwc_tb_11&amp;bizCode=taobao_avatar&quot;,
&quot;userNick&quot;: &quot;t**5&quot;,
&quot;auctionNumId&quot;: &quot;674104401994&quot;,
&quot;share&quot;: {
&quot;shareSupport&quot;: &quot;true&quot;,
&quot;shareCover&quot;: &quot;http://img.alicdn.com/imgextra/i2/0/O1CN01IDFWn823GTWURYkZL_!!0-tbbala.jpg&quot;,
&quot;shareURL&quot;: &quot;http://h5.m.taobao.com/user_comment/comment_detail.html?rateId=1176959653257&amp;sellerId=MMCI4PCPzv0RHvmNyvmgyOFgYv0leXFMeMCNLMkgLvkgT&amp;isEncode=true&quot;
},
&quot;copy&quot;: &quot;false&quot;,
&quot;id&quot;: &quot;1176959653257&quot;,
&quot;skuId&quot;: &quot;5021961230735&quot;,
&quot;userStar&quot;: &quot;8&quot;,
&quot;userStarPic&quot;: &quot;https://img.alicdn.com/tfs/TB1_40SzpY7gK0jSZKzXXaikpXa-447-78.png&quot;,
&quot;userMark&quot;: &quot;VUoz+M1vIq5AL6b5/ppFXK00B+fXcfLwg/3sLrc/LBI=&quot;,
&quot;interactInfo&quot;: {
&quot;likeCount&quot;: &quot;29&quot;,
&quot;readCount&quot;: &quot;15925&quot;,
&quot;alreadyLike&quot;: &quot;false&quot;,
&quot;commentCount&quot;: &quot;4&quot;
},
&quot;createTimeInterval&quot;: &quot;14天前&quot;,
&quot;skuMap&quot;: {
&quot;颜色分类&quot;: &quot;杏色.[预售]&quot;,
&quot;尺码&quot;: &quot;S&quot;
},
&quot;formalBlackUser&quot;: &quot;false&quot;,
&quot;goldUser&quot;: &quot;false&quot;,
&quot;allowComment&quot;: &quot;true&quot;,
&quot;userId&quot;: &quot;0&quot;,
&quot;feedPicPathList&quot;: [
&quot;http://img.alicdn.com/imgextra/i2/0/O1CN01IDFWn823GTWURYkZL_!!0-tbbala.jpg&quot;,
&quot;http://img.alicdn.com/imgextra/i1/0/O1CN01sxCruB23GTWVl5EVi_!!0-tbbala.jpg&quot;,
&quot;http://img.alicdn.com/imgextra/i2/0/O1CN01bjMY1y23GTWYlZjUd_!!0-tbbala.jpg&quot;
]
}
],
&quot;skuFilter&quot;: &quot;true&quot;,
&quot;feedGoodCount&quot;: &quot;179&quot;,
&quot;userType&quot;: &quot;0&quot;,
&quot;inviteText&quot;: &quot;&quot;
}
}</code></pre>
<h3>错误返回样例</h3>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;未查询到商品评价信息&quot;,
&quot;code&quot;: 701
}</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>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>701</td>
<td>未查询到商品评价信息</td>
</tr>
<tr>
<td>999</td>
<td>其他,以实际返回为准</td>
</tr>
</tbody>
</table>