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

item_get-根据ID取商品详情

ks.item_get 测试入口

公共参数

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

请求参数

请求参数：num_iid=79356974

参数说明：num_iid:商品ID ; delist_time不为空代表商品已下架;数据会获取异常。

响应参数

Version: Date:2023-05-29

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

请求示例（支持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"}
    }