一、业务背景
在电商竞品监控、跨平台 ERP、比价、选品系统开发场景中，很多开发者会选择爬虫抓取京东商品数据，但是爬虫存在 IP 封禁、页面改版、合规风险等问题。京东开放平台提供商品详情 API（jd.item_get），可以合法稳定获取商品结构化信息。本文对接口返回核心字段进行解读，并附带精简 JSON 样例，方便开发调试。
二、接口基础信息
接口名称：jd.item_get
接口网关：c0b.cc/R4rbK2
作用：批量查询京东商品基础详情、价格、图片、类目、SKU、库存、佣金等信息请求方式：HTTP POST，需要应用授权 + 签名校验适用场景：竞品数据分析、商品信息同步、比价系统、选品平台
请求关键入参
- goodsIds：商品 ID，支持多商品批量查询
- fields：指定需要返回的字段，按需拉取减少流量与响应耗时
三、核心返回字段解读
| 字段 | 含义 | 业务用途 |
|---|---|---|
| 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"}
五、开发重点注意事项
- 字段按需选取fields参数只勾选业务需要的字段，减少接口返回体积，降低接口超时、限流概率。
- 券后价计算逻辑 API 返回售价 + 优惠券信息，不能直接拿单一字段作为最终到手价，需要业务层叠加满减、优惠券逻辑自行计算。
- SKU 多规格处理一个商品 ID 下会包含多个 SKU，价格、库存是绑定子 SKU，不要直接取外层商品价格。
- 接口限流策略京东联盟 API 有 QPS 限制，批量采集时做好请求队列、延时、重试机制，避免触发限流。
- 数据时效性价格、库存属于动态数据，不要高频无限制轮询；业务侧做好本地缓存。
- 合规提醒使用官方开放 API，严格遵守京东开放平台协议；禁止超出授权范围大量爬取、转发数据。
六、适用业务场景
- 电商竞品监控系统，定时抓取价格、销量变动
- ERP 系统对接，商品基础资料自动同步
- 比价平台开发，实时监控商品优惠
- 跨境选品系统，采集国内京东商品素材做市场分析
七、小结
京东商品详情 API 可以获取结构化的商品标题、图片、类目、SKU、价格、优惠券、销量等数据，相比网页爬虫稳定性更高、维护成本更低。开发时重点处理 SKU 遍历、优惠叠加计算、接口限流重试三个难点，即可把数据接入业务系统。
