ITPub博客

首页 > 大数据 > 数据分析 > 京东开放API接口:item_get返回参数指南

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

原创 数据分析 作者:万邦科技Lafite 时间:2026-04-29 15:41:09 0 删除 编辑

京东开放平台的 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			}		}	}}


来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/70050022/viewspace-3117003/ ,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2026-04-28

  • 博文量
    33
  • 访问量
    34703