快手商品采集API商品列表API商品详情数据API接口获取快手商品信息API

淩亂°似流年 2024-02-05 14:00 10阅读 0赞

![702e7d227641417781b38327077c3b34.png][]

### 背景介绍 ###

快手商城是快手平台上的一个电商购物频道，类似于淘宝、京东等商城，用户可以通过搜索或者快手App首页的一级入口进入。目前，快手商城正在招商中，今年双11期间，快手将力推短视频、直播间、店铺、商城这一全新的商家经营矩阵。

据了解，今年8月快手已经对商城频道进行了灰度测试，商城的入口位于快手App首页顶部的Tab栏。灰度测试的商城首页包含了商品分类栏以及品牌补贴、超级秒杀和品牌特卖等频道。测试过程中发现，快手商城页面访问用户中，超过70%不是在短视频、直播间购买过东西的用户。

### API列表 ###

目前公司开发了关于快手商城商品的接口，分别是获取快手商品详情数据API：item\_get和关键字搜索商品列表API：item\_search。

商品详情接口item\_get是通过传入商品id，获取到商品的详情数据信息，包括宝贝标题、商品简介、价格、掌柜昵称、库存、宝贝链接、宝贝图片、品牌名称、品牌id、分类信息、商品详情、商品属性等。

有些人要问，那我去哪里获取到这些商品的商品id呢？通过关键字搜索接口可以获取到，item\_search获取传入关键字获取到这一类的商品id列表，支持翻页展示。

### 详细调用步骤 ###

1、[注册账号获取APIkey & secret][APIkey _ secret]。

2、开通需要测试的API接口权限。

3、进入测试页测试。

4、正式对接代码，接入商城。

公共参数

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <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>

请求参数

请求参数：num\_iid=79356974

参数说明：num\_iid:商品ID ; delist\_time不为空代表商品已下架;数据会获取异常。

响应参数

Version: Date:2023-05-29

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>示例值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> <p>item</p> </td> 
   <td>item[]</td> 
   <td>1</td> 
   <td></td> 
   <td>商品详情数据</td> 
  </tr> 
  <tr> 
   <td> <p>num_iid</p> </td> 
   <td>Bigint</td> 
   <td>1</td> 
   <td>20046611202546</td> 
   <td>商品ID</td> 
  </tr> 
  <tr> 
   <td> <p>title</p> </td> 
   <td>String</td> 
   <td>1</td> 
   <td>重磅200克男款休闲百搭【招财猫】纯棉短袖T恤</td> 
   <td>宝贝标题</td> 
  </tr> 
  <tr> 
   <td> <p>desc_short</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>商品简介</td> 
  </tr> 
  <tr> 
   <td> <p>price</p> </td> 
   <td>Float</td> 
   <td>1</td> 
   <td>11.93</td> 
   <td>价格</td> 
  </tr> 
  <tr> 
   <td> <p>total_price</p> </td> 
   <td>Float</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>orginal_price</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>11.93</td> 
   <td>原价</td> 
  </tr> 
  <tr> 
   <td> <p>suggestive_price</p> </td> 
   <td>Float</td> 
   <td>0</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>nick</p> </td> 
   <td>String</td> 
   <td>1</td> 
   <td>达人丽丽教搭配</td> 
   <td>掌柜昵称</td> 
  </tr> 
  <tr> 
   <td> <p>num</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td>库存</td> 
  </tr> 
  <tr> 
   <td> <p>min_num</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td>最小购买数</td> 
  </tr> 
  <tr> 
   <td> <p>detail_url</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20046611202546</td> 
   <td>宝贝链接</td> 
  </tr> 
  <tr> 
   <td> <p>pic_url</p> </td> 
   <td>String</td> 
   <td>1</td> 
   <td>https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg</td> 
   <td>宝贝图片</td> 
  </tr> 
  <tr> 
   <td> <p>brand</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>其他/other</td> 
   <td>品牌名称</td> 
  </tr> 
  <tr> 
   <td> <p>brandId</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td></td> 
   <td>品牌ID</td> 
  </tr> 
  <tr> 
   <td> <p>rootCatId</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td></td> 
   <td>顶级分类ID</td> 
  </tr> 
  <tr> 
   <td> <p>cid</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>0</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td> <p>crumbs</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td>导航菜单</td> 
  </tr> 
  <tr> 
   <td> <p>desc</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-2fd76963ba6e41b4bb52982191a97daf.jpg</td> 
   <td>商品详情</td> 
  </tr> 
  <tr> 
   <td> <p>desc_img</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[]</td> 
   <td>商品详情图片</td> 
  </tr> 
  <tr> 
   <td> <p>item_imgs</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>item_imgs[]</td> 
   <td>商品图片</td> 
  </tr> 
  <tr> 
   <td> <p>props_name</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>商品属性名</td> 
  </tr> 
  <tr> 
   <td> <p>prop_imgs</p> </td> 
   <td>prop_imgs[]</td> 
   <td>0</td> 
   <td></td> 
   <td>商品属性图片列表</td> 
  </tr> 
  <tr> 
   <td> <p>property_alias</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td></td> 
   <td>销售属性值别名</td> 
  </tr> 
  <tr> 
   <td> <p>props</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>[{name: "品牌",value: "其他/other"}]</td> 
   <td>商品属性</td> 
  </tr> 
  <tr> 
   <td> <p>skus</p> </td> 
   <td>skus[]</td> 
   <td>0</td> 
   <td></td> 
   <td>商品规格信息列表</td> 
  </tr> 
  <tr> 
   <td> <p>seller_id</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>407236546</td> 
   <td>卖家ID</td> 
  </tr> 
  <tr> 
   <td> <p>shop_id</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>407236546</td> 
   <td>店铺ID</td> 
  </tr> 
  <tr> 
   <td> <p>seller_info</p> </td> 
   <td>seller_info[]</td> 
   <td>0</td> 
   <td>卖家信息</td> 
   <td>Array</td> 
  </tr> 
 </tbody> 
</table>

[702e7d227641417781b38327077c3b34.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/f3b0572986aa45cbb2c95a6b0d9723e1.png
[APIkey _ secret]: http://o0b.cn/opjenn