接口用途:传入item_id微店商品 ID,返回完整商品结构化数据,用于私域 ERP、店铺迁移、分销选品、商品数据同步开发。返回格式为 JSON。
micro.item_get 微店商品详情 API 返回值说明
接口说明:micro.item_get,关键词 / 类目搜索获取淘宝商品列表,支持分页、排序,返回商品摘要数据;如需 SKU、详情图文,需要拿着num_iid调用商品详情接口二次补齐。返回格式 JSON。
接口标识:micro.item_get(微店商品详情API,taobaoapi2014前往体验)
请求网关: c0b.cc/R4rbK2 (HTTPS,支持 GET/POST)
接口版本:2.0
基础元数据:SPU 商品 ID、skuId、商品标题、品牌、类目、售卖状态、货号
媒体资源:主图数组、详情图片、商品短视频素材
SKU 规格数据:规格名称、各 SKU 售价、促销价、库存状态、限购规则
商品属性参数:产品规格、材质、包装清单等属性信息
附属业务信息:促销标签、市场参考价、区域限制相关字段
顶层响应结构
字段类型说明
codeint0调用成功;非 0 为错误码,如 token 失效、权限不足、商品不存在
msgstring响应文本,成功返回success;失败返回错误描述
request_idstring请求唯一 ID,线上日志排查、问题定位使用
dataobject商品详情业务主体对象
data 商品主体对象字段
字段类型说明
item_idstring微店商品唯一 ID,主键
titlestring商品主标题
sub_titlestring商品副标题,无则为空字符串
pricefloat销售现价(元)
market_pricefloat划线原价,无原价返回 0
vip_pricefloat会员专享价,无会员价返回 0
stockint商品总库存
salesint累计销量
is_on_saleint商品状态:1在售,0已下架
main_imagesarray[string]主图 URL 数组
desc_htmlstring商品详情富文本 HTML 源码
video_urlstring商品视频地址,无视频为空
sku_listarray[object]SKU 规格数组;无规格商品为空数组
is_distributionboolean是否开启分销:true 开启,false 关闭
commission_ratefloat分销佣金百分比,关闭分销返回0
post_feefloat基础运费(元)
is_free_shippingboolean是否包邮
shop_idstring店铺唯一 ID
shop_namestring店铺名称
is_shop_verifiedboolean店铺是否认证
category_idstring微店内部分类 ID
product_paramsarray[object]商品属性参数数组
sku_list SKU 规格子对象
字段类型说明
sku_idstringSKU 唯一编号
spec_namestring规格组合文本,例:黑色;XL
sku_picstringSKU 规格图地址,无图为空
sku_pricefloat该 SKU 售价
sku_stockint该 SKU 库存数量
product_params 属性参数子对象
字段类型说明
namestring参数名称,如面料、材质
valuestring参数对应值