微店商品列表 API 接口解析（附 JSON 样例）

摘要

在私域 ERP 系统、多店铺统一管理、店铺商品搬家、分销货源同步业务场景，需要批量获取微店店铺下全部商品清单，拿到商品 ID 之后再调用商品详情接口获取完整 SKU、图文、分销佣金等信息。

很多开发人员前期会直接抓取 H5 网页，但是微店前端页面频繁迭代、JS 动态渲染、账号风控、图片防盗链，爬虫维护成本高，并且存在合规风险。微店开放平台提供官方店铺商品列表接口weidian.item.shop.list.get，通过商家 OAuth 授权，分页返回店铺商品基础列表数据，是生产环境替代爬虫的标准化方案。

一、接口基础信息

micro.item_search 微店商品列表搜索接口，作为商品批量检索入口，输入关键词或类目 ID 获取微店商品摘要集合。

接口标识：micro.item_search （微店京东商品列表api，taobaoapi2014前往体验）

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

接口版本：2.0

接口能力覆盖

商品基础元数据：标题、售卖价、划线价、销量

店铺信息：店铺 ID、店铺名称，区分自营 / POP 店铺

辅助标记：广告商品标识、类目信息、发货地、自营标识

接口能力：获取指定店铺 / 类目下商品 SPU、SKU 列表，包含商品标题、SKU 编号、上下架状态、主图、价格、类目等基础信息。

适用业务场景

私域 ERP：定时同步授权店铺全部商品，监控上下架、价格变动

店铺搬家导出：批量获取店铺product_id，后续调用详情接口导出完整商品，迁移到其他平台

分销选品系统：拉取分销店铺商品列表，筛选高佣金货源

多店铺管理后台：聚合多家微店商品档案，做统一商品巡检

联动微店商品详情 API：列表拿到product_id入任务队列，异步拉取完整商品详情

二、请求核心参数            

三、完整 JSON 返回样例

{
    "code": 0,
    "msg": "success",
    "request_id": "wd20260922100500992233",
    "data": {
        "total": 86,
        "page_no": 1,
        "page_size": 10,
        "total_page": 9,
        "item_list": [
            {
                "product_id": "726589421001",
                "title": "复古棉麻文艺连衣裙 女夏季宽松中长款裙子",
                "sub_title": "透气棉麻｜多色可选",
                "shop_id": "158923601",
                "is_on_sale": 1,
                "publish_time": "2026‑04‑10 14:20:30",
                "price_cent": 12900,
                "market_price_cent": 19900,
                "total_stock": 2600,
                "total_sales": 3280,
                "is_free_shipping": false,
                "commission_rate": 12,
                "main_image": "https://img.weidian.com/kf/Haa1xxx.jpg"
            },
            {
                "product_id": "726589421002",
                "title": "简约帆布手提包 学生大容量托特包",
                "sub_title": "耐磨防水 多颜色可选",
                "shop_id": "158923601",
                "is_on_sale": 1,
                "publish_time": "2026‑05‑02 09:15:10",
                "price_cent": 4900,
                "market_price_cent": 8900,
                "total_stock": 5200,
                "total_sales": 6120,
                "is_free_shipping": true,
                "commission_rate": 10,
                "main_image": "https://img.weidian.com/kf/Hbb2xxx.jpg"
            }
        ]
    }
}

四、高频开发踩坑实录

价格单位混淆：列表接口返回价格单位是分，忘记除以 100，业务价格放大 100 倍；

token 跨店铺调用：A 店铺 access_token 不能读取 B 店铺，返回空数据；

时间戳错误：必须 13 位毫秒时间戳，秒级时间戳直接签名校验失败；

业务参数放外层：业务分页、状态参数必须放在param_json字符串内部，不能散落在外层公共参数；

分页超限：page_size最大 50，传入大于 50 的值会被平台截断；

token 过期失效：access_token 具备有效期，业务系统必须做预刷新，不能硬编码 token；

列表库存为汇总值：列表返回total_stock是汇总库存，想要每个 SKU 真实库存，必须调用商品详情接口；

下架商品字段残缺：is_on_sale=2下架商品部分字段为空，代码增加判空逻辑；

QPS 限流：批量全店同步任务，需要增加请求间隔，避免 429 限流报错。

五、业务拓展联动其他接口

拿到商品列表product_id集合之后，可以联动：

微店商品详情 API weidian.item.detail.get：获取 SKU、完整图文、分销详情；

AI 大模型：对商品标题、素材做改写、翻译，生成分销文案。