洞察电商数据：京东商品详情API数据模型
洞察电商数据：京东商品详情API数据模型
京东商品详情API是电商数据采集、竞品分析、选品调研、商品信息同步的核心接口，可获取商品全维度信息。本文整理标准通用数据模型，适配官方及合规第三方接口，兼顾开发对接与业务分析。
一、接口基础说明
1. 核心请求参数
num_iid：商品唯一ID，必填
skuId：单品规格ID，可选
appKey：开发者密钥，身份校验
sign：加密签名，保障调用安全
timestamp：请求时间戳
接口地址：c0b.cc/R4rbK2 ,无需自主申请接口（如添加Taobaoapi2014），直接调用封装API，一键获取已核算的券后价，适合批量查询、中小卖家使用。
2. 数据返回格式
接口统一返回JSON格式数据，包含状态码、提示信息、核心数据体三部分。
顶层结构
{ "code": 200, // 状态码，200=成功 "msg": "请求成功", // 返回提示 "data": { // 核心数据 "itemInfo": {}, // 基础信息 "priceInfo": {}, // 价格信息 "stockInfo": {}, // 库存信息 "skuInfo": {}, // 规格信息 "imageInfo": {}, // 多媒体信息 "shopInfo": {}, // 店铺信息 "saleInfo": {}, // 销售评价 "promoInfo": {}, // 促销信息 "otherInfo": {} // 补充信息 } }二、核心字段详情
1. 商品基础信息（itemInfo）
num_iid：商品唯一ID
title：商品完整标题
brand_name/brand_id：品牌名称、ID
goods_desc：商品详情描述
produce_area：产地
upc_code：商品UPC编码
2. 价格信息（priceInfo）
original_price：商品原价
current_price：当前售价
promo_price：促销价
coupon_price：券后到手价
3. 库存信息（stockInfo）
stock_num：实时库存数
stock_status：库存状态（1有货/0无货/2预售）
presale_time：预售发货时间
is_jd_self：是否京东自营
4. SKU规格信息（skuInfo）
sku_list：全规格列表
sku_id：单品规格ID
sku_name：规格名称
sku_price/sku_stock：规格单价、库存
spec_attr：规格属性（颜色、容量等）
5. 图片视频信息（imageInfo）
main_image：商品主图
image_list：轮播图
detail_image_list：详情图
video_url：商品视频链接
6. 店铺信息（shopInfo）
shop_id/shop_name：店铺ID、名称
shop_type：店铺类型
shop_score：店铺评分
7. 销售评价数据（saleInfo）
month_sales：近30天销量
total_sales：累计销量
comment_count：总评价数
good_comment_rate：好评率
avg_score：平均评分
8. 促销及补充信息
促销信息（promoInfo）
promo_title：活动名称
promo_type：活动类型
补充信息（otherInfo）
category_id/name：类目ID、名称
after_sale：售后服务
putaway_time：上架时间
goods_url：商品详情链接
三、调用注意事项
数据缓存：本地缓存数据，减少重复请求。
兼容处理：部分字段可能为空，做好异常适配。
实时更新：价格、库存为动态数据，定时同步。
四、应用场景
电商选品：筛选潜力爆款。
竞品监控：追踪价格、库存、活动动态。
商品同步：搭建独立站、分销平台。
数据分析：研判市场趋势，制定运营策略。