淘宝商品销量接口分享：获取淘宝商品总销量月销量

比眉伴天荒 2024-03-16 11:03 7阅读 0赞

*  item\_search\_sales 获得淘宝商品总销量
 *  月销通过商品详情接口item\_get，返回参数sales代表详情页上的月销

公共参数

<table> 
 <tbody> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>key</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用key（必须以GET方式拼接在URL中）</td> 
  </tr> 
  <tr> 
   <td>secret</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用密钥</td> 
  </tr> 
  <tr> 
   <td>api_name</td> 
   <td>String</td> 
   <td>是</td> 
   <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
  </tr> 
  <tr> 
   <td>result_type</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
  </tr> 
  <tr> 
   <td>lang</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>String</td> 
   <td>否</td> 
   <td>API版本</td> 
  </tr> 
 </tbody> 
</table>

item\_search\_sales 请求参数：

numid：商品id

shopid：店铺id

sellerid：卖家ID

item\_get请求参数：

num\_iid:淘宝商品ID

is\_promotion:是否获取取促销价

item\_get响应参数

Version: Date:2022-04-04

<table> 
 <tbody> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>示例值</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>item</td> 
   <td>item[]</td> 
   <td>1</td> 
   <td></td> 
   <td>宝贝详情数据</td> 
  </tr> 
  <tr> 
   <td>num_iid</td> 
   <td>Bigint</td> 
   <td>1</td> 
   <td></td> 
   <td>宝贝ID</td> 
  </tr> 
  <tr> 
   <td>title</td> 
   <td>String</td> 
   <td>1</td> 
   <td></td> 
   <td>宝贝标题</td> 
  </tr> 
  <tr> 
   <td>desc_short</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>商品简介</td> 
  </tr> 
  <tr> 
   <td>promotion_price</td> 
   <td>Int</td> 
   <td>0</td> 
   <td></td> 
   <td>优惠价</td> 
  </tr> 
  <tr> 
   <td>price</td> 
   <td>Float</td> 
   <td>1</td> 
   <td>25.8</td> 
   <td>价格</td> 
  </tr> 
  <tr> 
   <td>total_price</td> 
   <td>Float</td> 
   <td>0</td> 
   <td>0</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>suggestive_price</td> 
   <td>Float</td> 
   <td>0</td> 
   <td>0</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>orginal_price</td> 
   <td>String</td> 
   <td>0</td> 
   <td>25.80</td> 
   <td>原价</td> 
  </tr> 
  <tr> 
   <td>nick</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>掌柜昵称</td> 
  </tr> 
  <tr> 
   <td>num</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>3836</td> 
   <td>库存</td> 
  </tr> 
  <tr> 
   <td>min_num</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td>最小购买数</td> 
  </tr> 
  <tr> 
   <td>detail_url</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>宝贝链接</td> 
  </tr> 
  <tr> 
   <td>pic_url</td> 
   <td>String</td> 
   <td>1</td> 
   <td></td> 
   <td>宝贝图片</td> 
  </tr> 
  <tr> 
   <td>brand</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>品牌名称</td> 
  </tr> 
  <tr> 
   <td>brandId</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>8879363</td> 
   <td>品牌ID</td> 
  </tr> 
  <tr> 
   <td>rootCatId</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>50013886</td> 
   <td>顶级分类ID</td> 
  </tr> 
  <tr> 
   <td>cid</td> 
   <td>Int</td> 
   <td>1</td> 
   <td>50014822</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>crumbs</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td>导航菜单</td> 
  </tr> 
  <tr> 
   <td>created_time</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>modified_time</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>delist_time</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>desc</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>商品详情</td> 
  </tr> 
  <tr> 
   <td>desc_img</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td>商品详情图片</td> 
  </tr> 
  <tr> 
   <td>item_imgs</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>item_imgs[]</td> 
   <td>商品图片</td> 
  </tr> 
  <tr> 
   <td>item_weight</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>item_size</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>location</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>发货地</td> 
  </tr> 
  <tr> 
   <td>express_fee</td> 
   <td>Float</td> 
   <td>0</td> 
   <td>0.00</td> 
   <td>快递费用</td> 
  </tr> 
  <tr> 
   <td>ems_fee</td> 
   <td>Float</td> 
   <td>0</td> 
   <td></td> 
   <td>EMS费用</td> 
  </tr> 
  <tr> 
   <td>post_fee</td> 
   <td>Float</td> 
   <td>0</td> 
   <td></td> 
   <td>物流费用</td> 
  </tr> 
  <tr> 
   <td>shipping_to</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>发货至</td> 
  </tr> 
  <tr> 
   <td>has_discount</td> 
   <td>Boolean</td> 
   <td>0</td> 
   <td>false</td> 
   <td>是否有优惠</td> 
  </tr> 
  <tr> 
   <td>video</td> 
   <td>video[]</td> 
   <td>0</td> 
   <td></td> 
   <td>商品视频</td> 
  </tr> 
  <tr> 
   <td>is_virtual</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>sample_id</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>商品风格标识ID</td> 
  </tr> 
  <tr> 
   <td>is_promotion</td> 
   <td>Boolean</td> 
   <td>0</td> 
   <td>false</td> 
   <td>是否促销</td> 
  </tr> 
  <tr> 
   <td>props_name</td> 
   <td>String</td> 
   <td>0</td> 
   <td>1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;</td> 
   <td>商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。</td> 
  </tr> 
  <tr> 
   <td>prop_imgs</td> 
   <td>prop_imgs[]</td> 
   <td>0</td> 
   <td></td> 
   <td>商品属性图片列表</td> 
  </tr> 
  <tr> 
   <td>property_alias</td> 
   <td>String</td> 
   <td>0</td> 
   <td>20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色</td> 
   <td>销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。</td> 
  </tr> 
  <tr> 
   <td>props</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[{ "name": "产地","value": "中国" }]</td> 
   <td>商品属性</td> 
  </tr> 
  <tr> 
   <td>total_sold</td> 
   <td>Int</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>skus</td> 
   <td>skus[]</td> 
   <td>0</td> 
   <td></td> 
   <td>商品规格信息列表</td> 
  </tr> 
  <tr> 
   <td>seller_id</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>2844096782</td> 
   <td>卖家ID</td> 
  </tr> 
  <tr> 
   <td>sales</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>138</td> 
   <td>销量</td> 
  </tr> 
  <tr> 
   <td>shop_id</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>151372205</td> 
   <td>店铺ID</td> 
  </tr> 
  <tr> 
   <td>props_list</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>{20509:9974422: 尺码:36}</td> 
   <td>商品属性</td> 
  </tr> 
  <tr> 
   <td>seller_info</td> 
   <td>seller_info[]</td> 
   <td>1</td> 
   <td></td> 
   <td>卖家信息</td> 
  </tr> 
  <tr> 
   <td>tmall</td> 
   <td>Boolean</td> 
   <td>0</td> 
   <td>false</td> 
   <td>是否天猫</td> 
  </tr> 
  <tr> 
   <td>error</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>错误信息</td> 
  </tr> 
  <tr> 
   <td>warning</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>警告信息</td> 
  </tr> 
  <tr> 
   <td>url_log</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>favcount</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>fanscount</td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>method</td> 
   <td>String</td> 
   <td>0</td> 
   <td>item_tmall:pget_item</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>promo_type</td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>props_img</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>1627207:28326": "//<a href="https://link.zhihu.com/?target=http%3A//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_%21%212844096782.jpg" rel="nofollow" title="http://img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg">http://img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg</a></td> 
   <td>属性图片</td> 
  </tr> 
  <tr> 
   <td>shop_item</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>relate_items</td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
  </tr> 
 </tbody> 
</table>