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

背景介绍

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

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

API列表

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

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

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

详细调用步骤

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

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

3、进入测试页测试。

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

公共参数

名称	类型	必须	描述
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