快手商品详情API 商品销量API 商品列表API 获取商品价格数据API

╰+哭是因爲堅強的太久メ 2024-03-08 08:01 103阅读 0赞

### item\_get-根据ID取商品详情 ###

#### [ks.item\_get 测试入口][ks.item_get] ####

公共参数

<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>

请求示例（支持curl/PHP、Python、c\#、c++、Java、JavaScript等）

Python请求代码

# coding:utf-8
    """
    Compatible for python2.x and python3.x
    requirement: pip install requests
    """
    from __future__ import print_function
    import requests
    # 请求示例 url 默认请求参数已经做URL编码
    url = "https://api-服务器.cn/ks/item_get/?key=t8349951023&secret=20230904&num_iid=79356974"
    headers = {
        "Accept-Encoding": "gzip",
        "Connection": "close"
    }
    if __name__ == "__main__":
        r = requests.get(url, headers=headers)
        json_obj = r.json()
        print(json_obj)

响应示例（json）

"item": {
                "num_iid": "20046611202546",
                "title": "重磅200克男款休闲百搭【招财猫】纯棉短袖T恤",
                "desc_short": "",
                "price": 19.9,
                "total_price": 0,
                "suggestive_price": 0,
                "orginal_price": 0,
                "nick": "达人丽丽教搭配",
                "num": 0,
                "min_num": 0,
                "detail_url": "https://app.kwaixiaodian.com/page/kwaishop-goods-detail-h5-vue/detail?id=20046611202546",
                "pic_url": "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg",
                "brand": "其他/other",
                "brandId": null,
                "rootCatId": 0,
                "cid": 0,
                "crumbs": [],
                "created_time": "",
                "modified_time": "",
                "delist_time": "",
                "desc": [
                    "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-2fd76963ba6e41b4bb52982191a97daf.jpg",
                    "https://u2-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_DETAIL_IMAGE-407236546-56e029ac29624b3bb984bc11730bfe12.jpg",
                ],
                "desc_img": [],
                "item_imgs": [
                    {
                        "url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-515f399e73df4f228b0171dff65cef9a.jpg"
                    },
                    {
                        "url": "https://u1-203.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-407236546-68b7ad1802a9475e929adad9efe06bf2.jpg"
                    }
                ],
                "item_weight": "",
                "item_size": "",
                "location": "",
                "post_fee": "",
                "express_fee": "",
                "ems_fee": "",
                "shipping_to": "",
                "has_discount": "",
                "video": [],
                "is_virtual": "",
                "sample_id": "",
                "is_promotion": "",
                "props_name": null,
                "prop_imgs": {
                    "prop_img": []
                },
                "property_alias": "",
                "props": [
                    {
                        "name": "品牌",
                        "value": "其他/other"
                    },
                    {
                        "name": "主材质",
                        "value": "棉"
                    }
                ],
                "total_sold": "",
                "skus": {
                    "sku": [
                        {
                            "price": 19.9,
                            "total_price": 0,
                            "orginal_price": 0,
                            "properties": "20601742184:20601742196",
                            "properties_name": "20601742184:20601742196:白色:4XL 170-185斤;",
                            "quantity": 679,
                            "sku_id": 70581398202546
                        },
                        {
                            "price": 19.9,
                            "total_price": 0,
                            "orginal_price": 0,
                            "properties": "20601742184:20601742197",
                            "properties_name": "20601742184:20601742197:白色:5XL 185-200斤;",
                            "quantity": 685,
                            "sku_id": 70581398203546
                        }
                    ]
                },
                "seller_id": 407236546,
                "sales": "311",
                "shop_id": 407236546,
                "props_list": [],
                "seller_info": {
                    "nick": "达人丽丽教搭配",
                    "shop_type": null,
                    "user_num_id": 407236546,
                    "sid": 407236546,
                    "title": "达人丽丽教搭配",
                    "zhuy": "https://app.kwaixiaodian.com/page/kwaishop-c-shoplist?layoutType=4&enableWK=1&id=407236546",
                    "shop_name": "达人丽丽教搭配"
                },
                "tmall": "false",
                "warning": "",
                "url_log": [],
                "shop_name": "达人丽丽教搭配",
                "_ddf": "jf",
                "props_img": [],
                "format_check": "fail"
            },
            "error": "",
            "translate_status": "",
            "translate_time": 0,
            "language": {
                "default_lang": "cn",
                "current_lang": "cn"
            },
            "reason": "",
            "error_code": "0000",
            "cache": 0,
            "api_info": "today:5 max:30000 all[7=5+0+2];expires:2024-05-20",
            "execution_time": "0.579",
            "server_time": "Beijing/2023-05-29 11:21:26",
            "client_ip": "106.6.37.94",
            "call_args": {
                "num_iid": "20046611202546"
            },

异常示例

{
                "error": "item-not-found",
                "reason": "商品没找到",
                "error_code": "2000",
                "success": 0,
                "cache": 0,
                "api_info": "today:0 max:10000",
                "execution_time": 0.081,
                "server_time": "Beijing/2020-06-10 23:44:00",
                "call_args": [],
                "api_type": "ks",
                "request_id": "20046611202546"}
        }

[ks.item_get]: https://o0b.cn/jennif