京东商品详情 API 体系以SPU标准产品单元聚合、SKU库存单元明细为核心设计覆盖商家开放平台JOS、京东联盟两大核心场景支持单品 / 批量查询、全字段 / 指定字段返回完整承载商品主数据、规格、价格、库存、属性等全维度信息。以下从接口体系、核心参数、返回结构、字段解析、调用限制、实战方案全维度解读。一、核心概念SPU vs SKU京东定义SPUStandard Product Unit标准化产品单元代表一类商品如「iPhone 15 Pro」唯一标识为spuId聚合同款商品所有共性信息标题、品牌、类目、主图、详情。SKUStock Keeping Unit库存保有单位代表具体规格商品如「iPhone 15 Pro 256GB 蓝色」唯一标识为skuId京东商品详情页 URL 数字承载独立价格、库存、销售属性。关系1 个 SPU 对应 N 个 SKUAPI 以skuId为核心查询入口返回中自动关联spuId及同 SPU 下所有 SKU 列表。二、京东商品详情核心接口体系2026 官方1. 商家开放平台JOS接口企业 / 商家专用面向商家、ERP 服务商、自有系统对接数据最全、含真实库存 / 售后 / 店铺信息需企业认证 店铺授权。表格接口方法名旧版名称核心能力适用场景调用限制jingdong.item.read.getitem.jd.get单品详情全字段商品同步、SKU 明细、ERP 对接基础2QPS/1000 次日企业5~50QPSjingdong.item.list.getitem.jd.list.get批量详情≤20 SKU批量采集、价格监控、竞品分析同单品1 次 20 次单品调用jingdong.item.sku.get-单 SKU 明细含属性 / 库存SKU 规格查询、库存监控同单品接口jingdong.item.spu.get-SPU 基础信息聚合数据商品归类、同款推荐、类目分析基础1QPS/500 次日2. 京东联盟接口推广 / 选品专用面向 CPS 推广、比价工具、选品分析接入门槛低、含佣金 / 优惠券、无需店铺授权库存多为状态无精确数值。表格接口方法名核心能力适用场景调用限制jd.union.open.goods.detail.query联盟商品详情含佣金推广选品、价格监控、比价10QPS/5000~10 万次日jd.union.open.goods.skuid.querySKU 规格 / 价格查询推广 SKU 筛选、规格展示同联盟详情接口jd.union.open.goods.spu.querySPU 聚合信息含同款推广商品归类、同款推荐8QPS/5000 次日3. 补充接口组合调用必备价格专用jingdong.item.price.get实时价 / 促销价 / 会员价库存专用jingdong.item.stock.get区域库存 / 预售 / 锁定库存属性专用jingdong.item.property.getSPU 类目属性 / SKU 销售属性三、核心接口参数以jingdong.item.read.get为例1. 公共参数所有接口必传表格参数名类型必填说明methodString是接口方法名如jingdong.item.read.getapp_keyString是开放平台应用 ID注册应用获取access_tokenString是授权令牌商家接口需店铺授权timestampString是时间戳yyyy-MM-dd HH:mm:ss误差≤5minformatString是返回格式固定jsonvString是接口版本固定2.0signString是MD5 签名参数 ASCII 排序 AppSecret 加密2. 业务参数单品详情表格参数名类型必填说明sku_idString是京东商品 SKU ID详情页 URL 数字fieldsString否指定返回字段如sku_id,title,price,sku_list提升速度is_skuString否是否返回 SKU 明细1 是默认03. 业务参数批量详情jingdong.item.list.get表格参数名类型必填说明sku_idsString是逗号分隔 SKU ID≤20 个fieldsString否指定返回字段四、返回结构与核心字段解析JSON1. 成功返回结构jingdong.item.read.getjson{ jingdong_item_read_get_response: { result: { code: 0, msg: success, item: { sku_id: 100012345678, spu_id: 123456789, title: 华为Mate 60 Pro 12GB256GB 雅丹黑 全网通5G手机, price: 5999.00, market_price: 6999.00, brand_info: { brand_id: 1234, brand_name: 华为 }, category_info: { cid1: 1319, cid1_name: 手机 }, image_url: https://img14.360buyimg.com/n1/xxx.jpg, image_list: [https://img10.xxx.jpg, https://img11.xxx.jpg], sku_stock: 现货, stock_num: 128, sku_property: [ { property_name: 颜色, value_name: 雅丹黑 }, { property_name: 内存, value_name: 12GB256GB } ], sku_list: [ { sku_id: 100012345678, price: 5999.00, stock: 现货, properties: 颜色:雅丹黑;内存:12GB256GB }, { sku_id: 100087654321, price: 6499.00, stock: 预售, properties: 颜色:白沙银;内存:12GB512GB } ], specification: [ { key: 屏幕尺寸, value: 6.82英寸 }, { key: 处理器, value: 麒麟9000S } ] } } } }2. 核心字段分类解析1基础标识字段SPU/SKU 核心表格字段类型含义说明sku_idStringSKU 唯一 ID库存 / 定价最小单位spu_idStringSPU 唯一 ID同款商品聚合 IDtitleString商品标题含品牌 / 型号 / 规格brand_infoObject品牌信息品牌 ID 名称category_infoObject类目信息一级 / 二级 / 三级类目2价格字段表格字段类型含义说明priceString京东售价实时成交价market_priceString市场价划线价promotion_priceString促销价活动优惠价3库存字段表格字段类型含义说明sku_stockString库存状态现货 / 无货 / 预售stock_numInt可售库存精确数值仅商家接口is_pre_saleInt是否预售1 是0 否4SPU/SKU 属性字段核心表格字段类型含义说明sku_propertyArraySKU 销售属性颜色 / 尺寸 / 内存等规格sku_listArray同 SPU 下 SKU 列表含所有子 SKU 的 ID / 价格 / 库存specificationArray商品参数屏幕 / 处理器 / 材质等详情5图片字段表格字段类型含义说明image_urlString商品主图SPU 统一主图image_listArray详情图集多图轮播3. 错误返回结构json{ error_response: { code: 10003, msg: 调用频率超限, sub_code: isv.frequency-limit } }五、调用频率限制2026 官方标准1. 商家开放平台JOS个人 / 基础账号QPS≤2 次 / 秒分钟≤10 次日上限 1000 次企业认证账号默认 QPS5 次 / 秒可申请提升至 50 次 / 秒日上限 10 万次批量接口单次≤20 SKU1 次批量 20 次单品调用计数2. 京东联盟基础权限QPS≤10 次 / 秒日上限 5000 次高级权限QPS≤20 次 / 秒日上限 10 万次需联盟认证3. 常见错误码10003频率超限限流401签名错误403权限不足 / 未授权1004AppKey 无效六、实战调用方案SPU/SKU 数据获取1. 单 SKU 查询含同 SPU 所有 SKU入口jingdong.item.read.get传sku_id关键fields指定sku_list,sku_property获取全规格数据用途商品详情展示、SKU 规格选择、库存监控2. SPU 聚合查询同款商品入口先通过sku_id查spu_id→ 调用jingdong.item.spu.get传spu_id关键获取 SPU 基础信息 所有子 SKU 列表用途商品归类、同款推荐、竞品分析3. 批量高效查询推荐入口jingdong.item.list.get传sku_ids≤20优势减少调用次数规避限流效率提升 20 倍用途大批量商品同步、价格监控、ERP 对接七、高可用调用建议限流控制本地加令牌桶 / 漏桶QPS 控制在官方上限 80%批量优先≥5 个 SKU 必用批量接口减少调用计数字段精简fields指定所需字段避免全字段返回重试机制遇10003错误指数退避重试1s→2s→4s缓存策略非实时数据标题 / 参数缓存 1~2 小时降低调用量