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

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

一、接口基本信息

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

二、核心返回参数

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

基础信息模块（base_info）
- skuId：商品SKU ID，商品的唯一标识。
- title：商品标题。
- subtitle：商品副标题（如有）。
- brand：商品品牌名称。
- category：商品所属分类路径。
价格模块（price_info）
- price：商品当前售价（元）。
- originalPrice：商品原价（元）。
- discountPrice：商品折扣价（如有）。
- promotionPrice：商品促销价（如有）。
库存模块（stock_info）
- stock：商品库存数量。
- isAvailable：商品是否有货（布尔值）。
- limitPurchase：商品限购规则（如有）。
规格参数模块（sku_info）
- skuList ：商品规格列表，包含颜色、尺码、材质等详细信息。
  - skuId：规格SKU ID。
  - properties：规格属性，如颜色、尺码等。
  - price：规格价格（可能因规格不同而有所差异）。
  - stock：规格库存数量。
图片资源模块（image_info）
- mainImage：商品主图链接。
- imageList：商品图片列表，包含多张不同角度或场景的图片链接。
促销活动模块（promotion_info）
- promotions ：商品促销活动列表。
  - type：促销类型，如满减、折扣、赠品等。
  - description：促销活动描述。
  - startTime：促销活动开始时间（如有）。
  - endTime：促销活动结束时间（如有）。
店铺信息模块（shop_info）
- shopName：店铺名称。
- shopType：店铺类型，如自营、旗舰店等。
- shopScore：店铺评分（如有）。
销量信息模块（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
			}
		}
	}
}`