聚美智数


天猫商品搜索(暂停)

<h3>接口描述</h3> <ul> <li>天猫商品搜索,可应用于商品销售情况分析,电商选品分析,品牌口碑挖掘和竞争对手分析等。</li> <li>支持分页</li> </ul> <h3>请求地址</h3> <p><code>https://api.jumdata.com/tmall/goods/search</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>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</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>keyword</td> <td>String</td> <td>是</td> <td>关键字</td> </tr> <tr> <td>page</td> <td>int</td> <td>否</td> <td>分页页号,从1开始,默认1</td> </tr> <tr> <td>sort</td> <td>String</td> <td>否</td> <td>排序 &lt;br/&gt;credit-desc 信用&lt;br/&gt;sale-desc 销量&lt;br/&gt;price-asc 价格升序&lt;br/&gt;price-desc 价格降序&lt;br/&gt;total-asc 总价升序&lt;br/&gt;total-desc 总价降序 &lt;br/&gt;默认: credit-desc</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 = &amp;quot;xyzxy2121zxyz&amp;quot;; String timestamp = &amp;quot;1555378976238&amp;quot;; String appSecret = &amp;quot;efcefcef1121cefcefc1212121&amp;quot;; String str = appId + appSecret + timestamp; String sign = sha256(str);</code></pre> <h3>正确返回样例</h3> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 200, &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;, &amp;quot;taskNo&amp;quot;: &amp;quot;10370146262817747618&amp;quot;, &amp;quot;charge&amp;quot;: true, &amp;quot;data&amp;quot;: { &amp;quot;items&amp;quot;: [ { &amp;quot;comment_count&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;item_loc&amp;quot;: &amp;quot;上海&amp;quot;, &amp;quot;raw_title&amp;quot;: &amp;quot;adidas阿迪达斯RapidaSport BOA兔年新年男女小童旋转按钮运动鞋&amp;quot;, &amp;quot;view_fee&amp;quot;: &amp;quot;5.00&amp;quot;, &amp;quot;detail_url&amp;quot;: &amp;quot;//detail.tmall.com/item.htm?id=696537383845&amp;amp;ns=1&amp;amp;abbucket=18&amp;quot;, &amp;quot;p4pTags&amp;quot;: [], &amp;quot;categoryp&amp;quot;: &amp;quot;50012341 122650005 0&amp;quot;, &amp;quot;icon&amp;quot;: [ { &amp;quot;icon_key&amp;quot;: &amp;quot;icon-service-tianmao&amp;quot;, &amp;quot;show_type&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;trace&amp;quot;: &amp;quot;srpservice&amp;quot;, &amp;quot;icon_category&amp;quot;: &amp;quot;baobei&amp;quot;, &amp;quot;innerText&amp;quot;: &amp;quot;天猫宝贝&amp;quot;, &amp;quot;outer_text&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;html&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;position&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;dom_class&amp;quot;: &amp;quot;icon-service-tianmao&amp;quot;, &amp;quot;title&amp;quot;: &amp;quot;尚天猫,就购了&amp;quot;, &amp;quot;traceIdx&amp;quot;: 0, &amp;quot;url&amp;quot;: &amp;quot;//www.tmall.com/&amp;quot; }, { &amp;quot;icon_key&amp;quot;: &amp;quot;icon-service-xinpin&amp;quot;, &amp;quot;show_type&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;trace&amp;quot;: &amp;quot;srpservice&amp;quot;, &amp;quot;icon_category&amp;quot;: &amp;quot;baobei&amp;quot;, &amp;quot;innerText&amp;quot;: &amp;quot;新品&amp;quot;, &amp;quot;outer_text&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;html&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;position&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;dom_class&amp;quot;: &amp;quot;icon-service-xinpin&amp;quot;, &amp;quot;title&amp;quot;: &amp;quot;当季新品&amp;quot;, &amp;quot;traceIdx&amp;quot;: 1, &amp;quot;url&amp;quot;: &amp;quot;//service.taobao.com/support/knowledge-1138476.htm&amp;quot; } ], &amp;quot;nid&amp;quot;: &amp;quot;696537383845&amp;quot;, &amp;quot;comment_url&amp;quot;: &amp;quot;//detail.tmall.com/item.htm?id=696537383845&amp;amp;ns=1&amp;amp;abbucket=18&amp;amp;on_comment=1&amp;quot;, &amp;quot;shopName&amp;quot;: &amp;quot;天猫超市&amp;quot;, &amp;quot;pid&amp;quot;: &amp;quot;57245439&amp;quot;, &amp;quot;title&amp;quot;: &amp;quot;adidas&amp;lt;span class=H&amp;gt;阿迪达斯&amp;lt;/span&amp;gt;RapidaSport BOA兔年新年男女小童旋转按钮运动鞋&amp;quot;, &amp;quot;view_price&amp;quot;: &amp;quot;599.00&amp;quot;, &amp;quot;nick&amp;quot;: &amp;quot;天猫超市&amp;quot;, &amp;quot;view_sales&amp;quot;: &amp;quot;3人付款&amp;quot;, &amp;quot;user_id&amp;quot;: &amp;quot;725677994&amp;quot;, &amp;quot;i2iTags&amp;quot;: { &amp;quot;samestyle&amp;quot;: {}, &amp;quot;similar&amp;quot;: {} }, &amp;quot;shopLink&amp;quot;: &amp;quot;//store.taobao.com/shop/view_shop.htm?user_number_id=725677994&amp;quot;, &amp;quot;shopcard&amp;quot;: { &amp;quot;isTmall&amp;quot;: true, &amp;quot;delivery&amp;quot;: [ 488, 1, 184 ], &amp;quot;sellerCredit&amp;quot;: 20, &amp;quot;totalRate&amp;quot;: 10000, &amp;quot;service&amp;quot;: [ 490, 1, 496 ], &amp;quot;description&amp;quot;: [ 487, 1, 348 ], &amp;quot;encryptedUserId&amp;quot;: &amp;quot;UMGIbMCcuOFk0&amp;quot;, &amp;quot;levelClasses&amp;quot;: [ { &amp;quot;levelClass&amp;quot;: &amp;quot;icon-supple-level-jinguan&amp;quot; }, { &amp;quot;levelClass&amp;quot;: &amp;quot;icon-supple-level-jinguan&amp;quot; } ] }, &amp;quot;biz30day&amp;quot;: &amp;quot;3&amp;quot;, &amp;quot;risk&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;category&amp;quot;: &amp;quot;50012341&amp;quot;, &amp;quot;pic_url&amp;quot;: &amp;quot;//g-search3.alicdn.com/img/bao/uploaded/i4/i2/6000000000119/O1CN01Gd4PuZ1CkXwSPMnxQ_!!6000000000119-0-picassoopen.jpg&amp;quot; }, ... ] } }</code></pre> <h3>错误返回样例</h3> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 400, &amp;quot;msg&amp;quot;: &amp;quot;关键字不能为空&amp;quot;, &amp;quot;charge&amp;quot;: false }</code></pre> <h3>返回字段说明</h3> <table> <thead> <tr> <th>字段名</th> <th>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</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>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</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>999</td> <td>其他,以实际返回为准</td> </tr> </tbody> </table>

页面列表

ITEM_HTML