京东商品详情API能力解析与标准化应用方案（含JSON返回示例）

前言

一、接口简介

京东商品详情API是京东官方标准化数据接口，为电商服务商、ERP系统、选品工具、导购平台、铺货系统提供合规、稳定的商品结构化数据能力。开发者通过传入商品SKU，即可一次性获取京东商品完整详情数据，替代传统爬虫采集，数据规范、更新实时、稳定性高。

基础调用规范

请求方式：POST
返回格式：标准 JSON
鉴权方式：appKey + appSecret 签名校验
核心入参：skuId（商品唯一编码）

二、核心应用场景

该接口覆盖绝大多数京东电商数字化业务，是无货源、精品运营、CPS分销的底层数据支撑：

商品数据采集与跨平台铺货：自动抓取标题、图片、参数、SKU规格，实现一键商品搬家上架
价格与库存实时监控：定时同步货源售价、券后价、库存状态，避免亏损、超卖
大数据选品分析：依托销量、好评率、价格区间筛选优质货源
CPS导购与分销推广：获取佣金比例、优惠券、到手价，搭建带货体系
ERP供应链管理：实现京东货源标准化入库、自动调价、自动上下架

三、标准成功返回 JSON 示例（精简完整版）

{ "jd_union_open_goods_detail_query_response": { "code": "0", "msg": "success", "requestId": "req_2026072014080012", "result": { "goodsInfo": { "skuId": "100065474274", "title": "夏季纯棉宽松短袖女纯色百搭基础T恤多色可选", "brandName": "简禾", "categoryName": "女装 > T恤", "shopName": "简禾官方旗舰店", "isJdSelf": false, "itemUrl": "https://item.jd.com/100065474274.html", "priceInfo": { "originalPrice": "79.90", "discountPrice": "59.00" }, "couponInfo": { "couponDiscount": "10.00", "finalPrice": "49.00", "couponDesc": "满59减10" }, "commissionInfo": { "commissionRate": "12.50", "commissionMoney": "6.13" }, "salesInfo": { "monthSales": 2360, "totalSales": 9650 }, "stockInfo": { "totalStock": 460, "isSale": true }, "imageInfo": { "mainImg": "https://img.jd.com/imgextra/i1/main.jpg", "detailImgList": [ "https://img.jd.com/imgextra/i1/detail_01.jpg", "https://img.jd.com/imgextra/i1/detail_02.jpg" ] }, "skuList": [ { "skuId": "10006547427401", "specText": "白色 M", "skuPrice": "59.00", "skuStock": 180 }, { "skuId": "10006547427402", "specText": "黑色 XL", "skuPrice": "59.00", "skuStock": 125 } ], "productParams": [ {"name":"面料","value":"100%纯棉"}, {"name":"版型","value":"宽松"}, {"name":"季节","value":"夏季"} ], "commentSummary": { "goodRateShow": "96.5", "commentCount": 1420 } } } } }

四、核心字段说明（精简）

基础信息：商品SKU、标题、品牌、类目、店铺、自营标识、商品链接
价格体系：原价、售价、优惠券、券后到手价（用于比价、防亏损）
分销数据：佣金比例、预估佣金（CPS带货核心）
销售口碑：月销量、总销量、好评率（选品评分依据）
库存状态：总库存、是否在售（防超卖、自动下架）
素材图片：主图、详情图数组（铺货、素材采集）
SKU规格：各颜色尺码价格、库存（精细化同步）
商品参数：材质、属性、规格参数（商品结构化上架）

五、常见异常返回示例

1. 请求限流

{ "jd_union_open_goods_detail_query_response": { "code": "429", "msg": "请求过于频繁", "requestId": "req_2026072014081111" } }

2. 商品失效/下架

{ "jd_union_open_goods_detail_query_response": { "code": "400", "msg": "skuId不存在或商品已下架" } }

六、接入优势总结

京东商品详情API具备合规稳定、字段全面、结构统一、实时性强四大优势，可一站式解决京东货源选品、铺货、价格监控、库存同步、导购分销等业务难题。相比爬虫采集，官方接口无封禁风险、数据一致性高，是电商SaaS系统与自动化运营工具的标准对接方案。