摘要
在私域 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入任务队列，异步拉取完整商品详情
二、请求核心参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| app_key | string | 是 | 开放平台应用密钥 |
| method | string | 是 | 固定weidian.item.shop.list.get |
| timestamp | long | 是 | 13 位毫秒时间戳 |
| version | string | 是 | 固定1.0 |
| format | string | 是 | 固定json |
| access_token | string | 是 | 店铺 OAuth 授权令牌，token 与店铺一一绑定 |
| sign | string | 是 | HMAC‑SHA256 生成大写签名串 |
| param_json | string | 是 | 业务参数 JSON 字符串 |
三、完整 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 大模型：对商品标题、素材做改写、翻译，生成分销文案。
