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

原创

用户1597063760

发布于 2026-10-20 15:56:21

620

文章被收录于专栏：经验经验

一、业务背景

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

二、接口基础信息

接口名称：jd.item_get

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

请求关键入参

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

三、核心返回字段解读

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

四、精简 JSON 返回样例

{
  "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"
}