一、顶层响应状态——先看"门"开没开

字段	类型	说明
`code`	Integer	`200` 表示成功，非 200 需查错误码
`message`	String	成功返回 `"success"`，失败返回具体错误描述
`data`	Object	核心商品数据，失败时为 `null`

拿到响应的第一件事：判断 code == 200，否则直接走错误处理分支。

二、商品基础信息——谁在卖、卖什么

字段	示例	说明
`skuId`	`"100012345678"`	商品唯一标识，数据分析的主键
`spuId`	`"1000123456"`	商品聚合 ID，同一商品不同 SKU 共享
`title`	`"Redmi K60 Pro 5G手机 12GB+256GB 墨羽"`	商品标题，含品牌+型号+核心卖点
`brand`	`"Redmi"`	品牌名称
`category`	`"手机/数码/配件"`	分类路径，支持多级
`origin`	`"中国"`	商品产地
`shopName`	`"京东自营旗舰店"`	店铺名称
`shopType`	`"自营"`	店铺类型（自营/旗舰店/专营店）
`shopScore`	`"4.9"`	店铺评分

三、价格信息——交易环节的核心数据

这是分析师最关注的模块，京东返回的价格体系非常完整：

字段	类型	说明
`price` / `jdPrice`	Double	当前售价（如 `2999.00`）
`originalPrice`	Double	原价/吊牌价（如 `3299.00`），用于计算优惠力度
`promotionPrice`	Double	促销价（如 `2799.00`）， `isPromotion=true` 时有效
`discountPrice`	Double	折扣价（部分接口返回）
`promotion`	Object	促销活动详情
└ `type`	String	满减/折扣/赠品等
└ `desc`	String	`"满3000减300"`
└ `startTime`	Long	促销开始时间戳（毫秒）
└ `endTime`	Long	促销结束时间戳（毫秒）
`isPromotion`	Boolean	是否正在促销中

实战 tip： originalPrice - promotionPrice 就是用户感知的"优惠金额"，比单纯看折扣率更有说服力。

四、库存信息——注意"水分"

字段	类型	说明
`stock` / `stockNum`	Integer	库存数量（如 `568`）
`isAvailable` / `stock_state`	Boolean	`true`=有货， `false`=无货
`isStock`	Boolean	是否有库存
`areaStock`	Object	分地区库存，如 `{"Beijing":120,"Shanghai":98}`
`limitPurchase`	String	限购规则（如有）

⚠️ 关键提醒：京东可能不提供实时库存， stock 字段可能存在延迟，做库存预警时需结合业务经验判断。

五、SKU 规格列表——精细化分析的金矿

json"skuList": [  {  "skuId": "100012345678-1",  "name": "墨羽 12GB+256GB",  "price": 2999.00,  "stock": 50,  "properties": "颜色:黑色;尺码:L"  },  {  "skuId": "100012345678-2",  "name": "晴雪 16GB+512GB",  "price": 3999.00,  "stock": 30,  "properties": "颜色:白色;尺码:XL"  } ]

每个 SKU 是一个独立的价格-库存单元。做价格带分析、爆款 SKU 识别，全靠这个字段。

六、图片与视频——视觉资产

字段	说明
`mainImage` / `pic_url`	商品主图 URL（一张）
`images` / `imageList` / `detailImages`	详情图列表，通常 3-10 张
`videos`	商品视频 URL（如有）

图片 URL 域名通常为 img10.360buyimg.com 或 img.jd.com。

七、销售与评价——市场趋势的风向标

字段	类型	说明
`salesCount` / `totalSales`	Integer	累计销量（如 `89632`）
`monthlySales` / `monthSales`	Integer	月销量（如 `12560`）
`commentCount`	Integer	评价总数（如 `3256`）
`rating`	Float	评分（如 `4.5`）
`goodCommentsShare`	String	好评率（如 `"98%"`）
`reviews`	Array	评价内容列表（部分接口需单独调用）

月销量 ÷ 累计销量 ≈ 商品生命周期阶段，是判断新品/爆款/清仓品的关键指标。

八、规格参数与描述——产品差异化依据

字段	说明
`specInfo` / `specs`	规格参数，如 `{"颜色":["黑色","白色"],"内存":["8GB","12GB"]}`
`propertyInfo` / `attributes`	属性列表，如 `[{"name":"品牌","value":"华为"}]`
`description` / `detailDesc`	详细描述，可能含 HTML 标签
`features` / `highlights`	商品卖点/特性列表
`usageInstructions`	使用说明
`warranty`	保修信息
`afterSaleService`	售后服务
`returnPolicy`	退换货政策

完整返回结构一览

json{  "code": 200,  "message": "success",  "data": {  "skuId": "100012345678",  "title": "华为Mate 50 Pro 5G手机",  "price": 5999.00,  "originalPrice": 6999.00,  "promotion": {"type":"满减","desc":"满5000减500"},  "stock": 568,  "isAvailable": true,  "images": ["https://img10.360buyimg.com/..."],  "skuList": [...],  "specInfo": {"颜色":["曜金黑","冰霜银"],"内存":["8GB+128GB"]},  "salesCount": 89632,  "monthlySales": 12560,  "rating": 4.5,  "commentCount": 3256,  "shopName": "华为官方旗舰店",  "shopScore": "4.9"  } }

接入要点速查

事项	要求
权限	需在京东开放平台注册并审核通过，获取 `app_key` + `app_secret`
签名	调用时需按文档生成 `sign` 签名，保障安全
频率	有调用限制，建议做数据缓存，避免重复请求
格式	默认 JSON，也支持 XML，可通过 `result_type` 参数指定
语言	`lang=cn` 简体中文， `en` 英文， `ru` 俄文

一句话总结：京东商品详情 API 返回的不只是一串数据，而是一张完整的"商品身份证"——从价格策略到库存分布，从 SKU 矩阵到用户口碑，所有分析维度一网打尽。用好它，你的竞品分析和选品决策将从"凭感觉"进化到"看数据"。

ITPub博客

京东商品详情 API 返回值全面解读