京东开放API接口：item_get返回参数指南

京东开放平台的item_get接口是获取商品详情的核心API，支持一键拉取商品标题、价格、SKU、库存、图片等结构化数据。以下是该接口返回参数的详细指南：

一、接口基本信息

• 接口名称：商品详情查询（jd.item.get）
• 请求方式：推荐使用POST，也支持GET
• 响应格式：JSON（默认）/ XML
• 接口地址：正式环境地址可能因平台更新而变化，需参考京东开放平台最新文档

二、核心返回参数

接口返回的JSON数据包含多层嵌套结构，核心模块及参数说明如下：

1. 基础信息模块（base_info）

   • skuId：商品SKU ID，商品的唯一标识。
   • title：商品标题。
   • subtitle：商品副标题（如有）。
   • brand：商品品牌名称。
   • category：商品所属分类路径。

2. 价格模块（price_info）

   • price：商品当前售价（元）。
   • originalPrice：商品原价（元）。
   • discountPrice：商品折扣价（如有）。
   • promotionPrice：商品促销价（如有）。

3. 库存模块（stock_info）

   • stock：商品库存数量。
   • isAvailable：商品是否有货（布尔值）。
   • limitPurchase：商品限购规则（如有）。

4. 规格参数模块（sku_info）

   • skuList：商品规格列表，包含颜色、尺码、材质等详细信息。

     • skuId：规格SKU ID。
     • properties：规格属性，如颜色、尺码等。
     • price：规格价格（可能因规格不同而有所差异）。
     • stock：规格库存数量。

5. 图片资源模块（image_info）

   • mainImage：商品主图链接。
   • imageList：商品图片列表，包含多张不同角度或场景的图片链接。

6. 促销活动模块（promotion_info）

   • promotions：商品促销活动列表。

     • type：促销类型，如满减、折扣、赠品等。
     • description：促销活动描述。
     • startTime：促销活动开始时间（如有）。
     • endTime：促销活动结束时间（如有）。

7. 店铺信息模块（shop_info）

   • shopName：店铺名称。
   • shopType：店铺类型，如自营、旗舰店等。
   • shopScore：店铺评分（如有）。

8. 销量信息模块（sales_info）

   • salesCount：商品累计销量。
   • monthlySales：商品月销量（如有）。

三、示例返回数据

json
{
	"jingdong_item_get_response": {
		"result": {
			"code": "0", // 成功码
			"base_info": {
				"skuId": "123456789",
				"title": "京东商品名称",
				"brand": "品牌名称",
				"category": "手机/数码/配件"
			},
			"price_info": {
				"price": "99.99",
				"originalPrice": "109.99"
			},
			"stock_info": {
				"stock": 200,
				"isAvailable": true
			},
			"sku_info": {
				"skuList": [
					{
						"skuId": "123456789-1",
						"properties": "颜色:黑色;尺码:L",
						"price": "99.99",
						"stock": 100
					}
				]
			},
			"image_info": {
				"mainImage": "https://image.jd.com/商品主图.jpg",
				"imageList": [
					"https://image.jd.com/商品详情图1.jpg",
					"https://image.jd.com/商品详情图2.jpg"
				]
			},
			"promotion_info": {
				"promotions": [
					{
						"type": "满减",
						"description": "满500减300",
						"startTime": "2026-04-01 00:00:00",
						"endTime": "2026-04-30 23:59:59"
					}
				]
			},
			"shop_info": {
				"shopName": "京东自营旗舰店",
				"shopType": "自营",
				"shopScore": "4.9"
			},
			"sales_info": {
				"salesCount": 1500,
				"monthlySales": 500
			}
		}
	}
}