一文读懂京东商品详情 API：返回字段解读与 JSON 样例

一、业务背景

在电商竞品监控、跨平台 ERP、比价、选品系统开发场景中，很多开发者会选择爬虫抓取京东商品数据。京东平台提供商品详情 API（jd.item_get），可以合法稳定获取商品结构化信息。本文对接口返回核心字段进行解读，并附带精简 JSON 样例，方便开发调试。

二、接口基础信息

接口名称：jd.item_get 作用：批量查询京东商品基础详情、价格、图片、类目、SKU、库存、佣金等信息请求方式：HTTP POST，需要应用授权 + 签名校验适用场景：竞品数据分析、商品信息同步、比价系统、选品平台。

请求关键入参

goodsIds：商品 ID，支持多商品批量查询
fields：指定需要返回的字段，按需拉取减少流量与响应耗时

三、核心返回字段解读

字段	含义	业务用途
api name	接口简称	jd.item_get（Taobaoapi2014前往体验）
api adress	接口网关	c0b.cc/R4rbK2
skuId	商品 SKU 编号	唯一标识单品，价格、库存绑定此 ID
goodsName	商品标题	商品名称，用于展示、检索
categoryInfo	类目信息	一级 / 二级类目，用于商品分类、选品筛选
mainImage	主图地址	商品封面图，可同步至 ERP / 商城
images	详情图片数组	多图素材，商品刊登使用
priceInfo	价格对象	原价、售价、券后价、预售价，比价核心数据
stockState	库存状态	判断商品是否可售卖
skuList	SKU 规格列表	多规格商品（颜色、尺寸）的子商品集合
brandInfo	品牌信息	品牌名称、品牌 ID，竞品品牌统计
salesInfo	销量相关数据	商品销量，竞品热度分析
couponInfo	优惠券数组	可用券信息，用于计算券后到手价

四、精简 JSON 返回样例

python 复制代码

{
  "code": 200,
  "data": {
    "goodsList": [
      {
        "skuId": 100012345678,
        "goodsName": "无线蓝牙机械键盘 办公静音",
        "mainImage": "https://img14.360buyimg.com/xxx.jpg",
        "images": [
          "https://img14.360buyimg.com/xxx1.jpg",
          "https://img14.360buyimg.com/xxx2.jpg"
        ],
        "categoryInfo": {
          "cid1": 670,
          "cid1Name": "电脑、办公",
          "cid2": 677,
          "cid2Name": "键盘"
        },
        "brandInfo": {
          "brandId": 12345,
          "brandName": "XX数码"
        },
        "priceInfo": {
          "originalPrice": 199.00,
          "salePrice": 129.00,
          "couponPrice": 99.00
        },
        "stockState": 1,
        "salesInfo": {
          "sales": 12580
        },
        "couponInfo": [
          {
            "couponId": "cp20261001",
            "discount": 30,
            "quota": 100
          }
        ],
        "skuList": [
          {
            "skuId": 100012345679,
            "skuName": "黑色 87键",
            "skuPrice": 99.00
          },
          {
            "skuId": 100012345680,
            "skuName": "白色 87键",
            "skuPrice": 99.00
          }
        ]
      }
    ]
  },
  "message": "success"
}

五、开发重点注意事项

字段按需选取 fields参数只勾选业务需要的字段，减少接口返回体积，降低接口超时、限流概率。
券后价计算逻辑 API 返回售价 + 优惠券信息，不能直接拿单一字段作为最终到手价，需要业务层叠加满减、优惠券逻辑自行计算。
SKU 多规格处理 一个商品 ID 下会包含多个 SKU，价格、库存是绑定子 SKU，不要直接取外层商品价格。
接口限流策略 京东联盟 API 有 QPS 限制，批量采集时做好请求队列、延时、重试机制，避免触发限流。
数据时效性 价格、库存属于动态数据，不要高频无限制轮询；业务侧做好本地缓存。
合规提醒 使用官方开放 API，严格遵守京东开放平台协议；禁止超出授权范围大量爬取、转发数据。

六、适用业务场景

电商竞品监控系统，定时抓取价格、销量变动
ERP 系统对接，商品基础资料自动同步
比价平台开发，实时监控商品优惠
跨境选品系统，采集国内京东商品素材做市场分析

七、小结

京东商品详情 API 可以获取结构化的商品标题、图片、类目、SKU、价格、优惠券、销量等数据，相比网页爬虫稳定性更高、维护成本更低。开发时重点处理 SKU 遍历、优惠叠加计算、接口限流重试三个难点，即可把数据接入业务系统。