一、核心接口信息
- 常用接口
基础接口:jd.item_get(获取核心商品数据)
全量接口:jd.item_get_pro(获取完整详情,含图文、售后、运费)
请求方式:POST/GET,返回格式:JSON
- 必传参数
接口地址:无需自主申请接口(如添加Taobaoapi2014),直接调用封装API,一键获取已封装的商品详情页面数据,适合批量查询、中小卖家使用。
item_id/sku_id:商品ID,精准定位商品
timestamp:请求时间戳
二、标准数据模型
接口返回数据层级清晰,分为七大核心模块,覆盖全品类商品字段:
{
"code": 200,
"message": "success",
"result": {
"base": "商品基础信息",
"price": "价格与促销",
"stock": "库存状态",
"spec": "规格与SKU",
"image": "图片视频",
"sales": "销量评价",
"service": "售后物流"
}
}
三、核心字段详解
- 基础信息(base)
skuId:最小库存单元ID(唯一标识)
spuId:商品聚合ID
productName:商品标题
brandName:品牌名称
category:类目路径
- 价格促销(price)
jdPrice:京东售价
marketPrice:市场价(划线价)
promotionPrice:活动促销价
coupon:优惠券信息
- 库存状态(stock)
stockNum:可售库存
stockState:库存状态(有货/无货/预售)
isPreSale:是否预售
- 规格SKU(spec)
specList:规格属性(颜色、尺寸等)
skuList:多规格SKU集合
props:详细参数
- 图片资源(image)
mainImage:商品主图
imageList:详情图集
videoUrl:商品视频
- 销量评价(sales)
saleCount:销量数据
commentCount:评价总数
goodCommentRate:好评率
四、关键标识说明
SPU:代表一类商品(如某款手机)
SKU:代表单个规格(如手机+颜色+容量),是库存、定价最小单位
调取详情优先用SKU ID,数据更精准