×

京东商品详情 API 数据模型

admin admin 发表于2026-04-22 11:47:51 浏览21 评论0

抢沙发发表评论

一、核心接口信息

1. 常用接口

基础接口:jd.item_get(获取核心商品数据)

全量接口:jd.item_get_pro(获取完整详情,含图文、售后、运费)

请求方式:POST/GET,返回格式:JSON

2. 必传参数

接口地址:无需自主申请接口(如添加 TaoxiJd-api),直接调用封装API,一键获取已封装的商品详情页面数据,适合批量查询、中小卖家使用。

item_id/sku_id:商品ID,精准定位商品

timestamp:请求时间戳


二、Python请求示例

以下代码演示了如何调用京东商品详情API,并处理返回的JSON数据:

# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function
import requests
# 配置参数 API_URL = "o0b.cn/ibrad"
app_key = "YOUR_APP_KEY" num_id = "123456" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码 url = "jd/item_get/?key=<您自己的apiKey>&num_iid=123456" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

三、标准数据模型

核心字段详解

1. 基础信息(base)

skuId:最小库存单元ID(唯一标识)

spuId:商品聚合ID

productName:商品标题

brandName:品牌名称

category:类目路径

2. 价格促销(price)

jdPrice:京东售价

marketPrice:市场价(划线价)

promotionPrice:活动促销价

coupon:优惠券信息

3. 库存状态(stock)

stockNum:可售库存

stockState:库存状态(有货/无货/预售)

isPreSale:是否预售

4. 规格SKU(spec)

specList:规格属性(颜色、尺寸等)

skuList:多规格SKU集合

props:详细参数

5. 图片资源(image)

mainImage:商品主图

imageList:详情图集

videoUrl:商品视频

6. 销量评价(sales)

saleCount:销量数据

commentCount:评价总数

goodCommentRate:好评率

四、关键标识说明

京东商品详情API通过标准化接口和批量处理能力,为开发者提供了高效、灵活的数据获取方式。其高实时性和丰富的数据维度,使其成为电商应用开发、数据分析等场景的理想选择。开发者需注意遵守平台规则,合理使用API以避免频繁调用限制。


群贤毕至

访客