微店商品详情API接口解析（附 JSON 样例）

原创

用户1597063760

发布于 2026-09-21 17:03:30

490

文章被收录于专栏：经验经验

摘要

在私域 ERP 系统、微店店铺搬家、多店铺商品同步、分销选品、货源监控业务中，需要获取微店完整商品结构化数据。很多开发者初期选择网页爬虫抓取微店详情页，会遇到 H5 页面改版、JS 动态渲染、账号风控、图片防盗链等问题，维护成本高，还存在合规风险。

微店开放平台提供官方商品详情接口 weidian.item.detail.get，通过 OAuth 店铺授权，返回标题、价格、SKU 规格、库存、图文素材、分销佣金、运费模板等标准化 JSON 数据，适合替代爬虫做私域电商系统开发。本文完整解析接口规范、请求参数、返回字段、调用流程与生产踩坑，附带可复用 JSON 样例。

一、接口基础信息

微店商品详情 API 接口（item_get - 获得微店商品详情 API 接口），微店 API 接口代码对接可以获取到宝贝 ID，宝贝标题，价格，掌柜名称，库存，最小购买数，宝贝链接，宝贝图片，品牌名称，商品详情。

接口标识：micro.item_get（微店商品详情API，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

请求方式：GET / POST

适用业务场景

私域 ERP：微店商品数据同步，库存、价格定时监控

店铺搬家：导出微店商品，迁移到其他私域 / 电商平台

分销选品系统：读取分销佣金、商品基础信息做选品

多店铺管理平台：统一聚合多家微店商品档案

联动微店商品列表 API：列表拿到product_id，批量拉取商品完整详情。

二、请求核心参数

参数名	类型	是否必填	说明
method	string	是	固定值 weidian.item.detail.get
timestamp	long	是	13 位毫秒时间戳，时间偏差过大直接鉴权失败
version	string	是	固定1.0
format	string	是	固定json
access_token	string	是	店铺 OAuth 授权令牌，token 绑定对应店铺
sign	string	是	HMAC‑SHA256 生成签名串
param_json	string	是	业务参数 JSON 字符串：{"product_id":"xxx"}

三、完整 JSON 返回样例

{
    "code": 0,
    "msg": "success",
    "request_id": "wd20260921161000887711",
    "data": {
        "product_id": "726589421001",
        "title": "复古棉麻文艺连衣裙 女夏季宽松中长款裙子",
        "sub_title": "透气棉麻｜多色可选",
        "shop_id": "158923601",
        "shop_name": "文艺女装源头小店",
        "is_on_sale": 1,
        "publish_time": "2026‑04‑10 14:20:30",
        "price_cent": 12900,
        "market_price_cent": 19900,
        "vip_price_cent": 11900,
        "total_stock": 2600,
        "total_sales": 3280,
        "total_view": 18600,
        "is_free_shipping": false,
        "post_fee_cent": 800,
        "commission_rate": 12,
        "commission_max_cent": 1548,
        "main_images": [
            "https://img.weidian.com/kf/Haa1xxx.jpg",
            "https://img.weidian.com/kf/Hbb2xxx.jpg"
        ],
        "detail_images": [
            "https://img.weidian.com/kf/Hcc3xxx.jpg"
        ],
        "desc_html": "<p>面料：100%棉麻，宽松版型，适合夏季穿着</p>",
        "product_params": [
            {"name":"面料","value":"棉麻"},
            {"name":"版型","value":"宽松"}
        ],
        "sku_list": [
            {
                "sku_id": "726589421001‑01",
                "spec_text": "米白色 S",
                "sku_price_cent": 12900,
                "sku_stock": 860,
                "sku_image": "https://img.weidian.com/kf/Hs1xxx.jpg"
            },
            {
                "sku_id": "726589421001‑02",
                "spec_text": "雾霾蓝 M",
                "sku_price_cent": 12900,
                "sku_stock": 920,
                "sku_image": "https://img.weidian.com/kf/Hs2xxx.jpg"
            }
        ],
        "delivery_from": "浙江杭州",
        "delivery_promise": "48小时内发货"
    }
}

四、核心返回字段释义

字段	数据类型	字段释义	业务处理逻辑
code	int	状态码	0 成功；非 0 为权限、签名、参数异常
request_id	string	请求唯一 ID	线上排查日志、对接工单
product_id	string	商品 ID	主键，关联列表接口、用于后续更新
is_on_sale	int	售卖状态	1 在售，0 下架；下架商品部分字段为空，需判空
price_cent	long	售价（单位：分）	除以 100 转为元，业务展示
market_price_cent	long	划线价（分）	商品原价
vip_price_cent	long	会员专享价（分）	无会员价返回 0
is_free_shipping	boolean	是否包邮	true 则运费post_fee_cent无效
commission_rate	int	分销佣金百分比	分销选品使用
main_images	array	主图数组	CDN 防盗链，不可直接对外分发
desc_html	string	详情富文本 HTML	商品详情内容
sku_list	array	SKU 规格数组	部分单规格商品该数组长度为 0，必须做空判断
delivery_from	string	发货地	用于供应链评估发货时效