摘要
在私域 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,批量拉取商品完整详情。
二、接入完整调用流程
开放平台准备:微店开放平台完成开发者认证,创建应用,申请商品详情接口权限;
参数组装签名:公共参数按 ASCII 升序排序,HMAC‑SHA256 生成 sign,业务参数封装进param_json;
发起 POST 请求,传入product_id;
数据解析与单位转换:价格、佣金从 “分” 转 “元”;SKU 数组做判空,处理下架商品字段缺失;
持久化入库:结合微店商品列表 API,批量同步商品;定时任务做库存、价格增量更新。
三、业务拓展
拿到商品详情数据后,可联动:
微店商品列表 API:批量获取店铺全部product_id,批量采集详情;
AI 大模型:对标题、详情做改写翻译,生成分销文案。