版本V2.0适用ERP、跨境铺货、竞品监控、反向海淘代购、选品中台、比价系统 定位根据 SKU 编号获取京东商品完整结构化详情本手册包含接口规范、标准 JSON 样例、8 大业务场景落地、缓存限流策略、踩坑清单、Python 最小可运行 Demo一、接口基础说明1.1 接口区分选型必看接口官方名称适用对象核心差异jd.item.get商品详情查询供应链、铺货、代购、竞品监控全量图文、SKU、价格、促销库存为区域可售库存无需京东店铺授权jingdong.item.read.get商家商品读取京东 POP / 自营商家 ERP精确仓配库存、可联动订单售后必须拥有京东店铺jd.union.open.goods.detail.query联盟商品详情CPS 导购、小程序自带佣金、推广链接无实时精准库存本手册以jd.item.get第三方通用详情接口为主HTTPS POST 调用返回 JSON版本 v2.0。1.1 基础信息接口名称jd.item.get淘宝商品详情APItaobaoapi2014前往体验正式网关c0b.cc/R4rbK2请求方式HTTPS GET / POST返回格式json /xml推荐 jsonAPI 版本v2.0核心能力根据num_iid商品 ID查询商品基础信息、价格、SKU、图文、类目、规格参数、上下架状态1.2 请求公共参数参数类型是否必传说明methodstring是jd.item.getapp_keystring是应用 keyapp_secretstring是密钥用于 MD5 签名禁止硬编码skuIdstring是京东 SKU 编号10 位数字核心入参areastring否区域编码1_72_2799_0决定该地区价格、库存、运费不传默认北京区域数据会造成价格库存失真fieldsstring否按需筛选返回字段例如skuId,title,priceInfo,skuList,stockInfo减少报文体积vstring是接口版本固定2.0timestampstring是13 位毫秒时间戳服务器时间偏差不可大于 5 分钟否则签名报错sign_methodstring是md5formatstring否json签名规则所有非空参数按 ASCII 升序排序拼接 secretMD5 大写输出 sign 签名值。1.3 标准返回 JSON 示例精简json{ code: 200, msg: success, data: { skuId: 100012345678, title: 2026新款高性能轻薄笔记本电脑, subTitle: 金属机身14英寸高清屏, brand: { brandId: 10086, brandName: 联想, brandLogo: https://img10.360buyimg.com/brand/logo/xxx.jpg }, category: { cid1: 670, cid1Name: 电脑办公, cid2: 671, cid2Name: 笔记本, cid3: 672, cid3Name: 轻薄本 }, priceInfo: { marketPrice: 5999.00, jdPrice: 5499.00, promotionPrice: 5299.00, memberPrice: 5199.00, currency: CNY, promotionList: [ { promotionId: 88661, promotionName: 满5000减200, promotionType: full_reduce, startTime: 2026‑07‑01 00:00:00, endTime: 2026‑08‑31 23:59:59 } ] }, stockInfo: { stockNum: 368, availableStock: 312, isAvailable: true, limitPurchase: 限购2件, preSaleStatus: 0 }, salesInfo: { totalSales: 12680, monthSales: 2420 }, imageInfo: { mainImage: https://img14.360buyimg.com/n1/jfs/txxx.jpg, imageList: [ https://img14.360buyimg.com/n1/jfs/txxx1.jpg, https://img14.360buyimg.com/n1/jfs/txxx2.jpg ] }, skuList: [ { subSkuId: 10001234567801, properties: 颜色:深空灰;内存:16G512G, skuPrice: 5299.00, skuStock: 126 }, { subSkuId: 10001234567802, properties: 颜色:银色;内存:16G1T, skuPrice: 5699.00, skuStock: 88 } ], shopInfo: { shopId: 100998, shopName: 联想京东自营旗舰店, shopType: self }, attributeList: [ {attrName:CPU型号,attrValue:Intel i7‑1360P}, {attrName:屏幕尺寸,attrValue:14英寸} ], descHtml:div商品详情HTML正文……/div, logisticsInfo:{ isFreeShipping:true, nextDayArrival:true } } }错误码说明1000签名错误时间不同步、参数漏传、secret 错误2001权限不足接口未开通429调用频率超限7接口网关超时50001skuId 不存在 / 已下架二、八大业务场景完整落地方案场景 1跨平台铺货1688/Ozon/Temu/Shopee 一键搬家业务目标采集京东商品清洗后刊登至跨境、国内第三方店铺替代爬虫保证字段稳定。需要字段title、imageList、attributeList、skuList、priceInfo、descHtml、brand、category落地逻辑调用 jd.item.get 获取原始 JSON图片 URL 处理京东图片域名360buyimg.com部分平台不允许外链必须下载转存对象存储替换图片地址属性映射京东类目→目标平台类目映射表结构化属性转为目标平台规格参数SKU 映射京东 subSkuId 映射外部平台 sku 编码价格做汇率 / 利润加成过滤 HTML 内京东站内跳转链接清理广告标签缓存策略标题、图片、属性缓存24h不要每次刊登都调用风险点京东部分商品图片有防盗链直接粘贴刊登会裂图必须本地化转存。场景 2竞品价格 促销监控系统品牌 / 渠道商业务目标定时监控竞品价格变动、大促活动上线价格跌破阈值自动预警。需要字段priceInfo、promotionList、stockInfo、skuList落地逻辑Redis 存储历史价格快照keyskuId存储历史价格、活动、时间定时任务轮询重点竞品 5‑10 分钟调用一次长尾商品 30‑60 分钟真实到手价计算逻辑真实到手价 min(promotionPrice,memberPrice)叠加满减、优惠券后做预估算对比快照发生价格下跌、新增活动、库存清零推送企业微信 / 钉钉告警区分标价 marketPrice 仅做划线展示不能作为实际售价限流策略令牌桶QPS 不超过接口配额 80%防止 429坑area 区域参数缺失拿到北京价格和业务实际销售地区不一致造成误告警。场景 3ERP 货源同步以京东为供货源业务目标同步京东 SKU 售价、可售库存防止超卖、亏损下单。需要字段stockInfo、skuList、priceInfo、isAvailable落地逻辑热销 SKU缓存 5‑10 分钟长尾 SKU 缓存 30 分钟业务下单前绕过缓存直接调用一次接口校验可售库存解析preSaleStatus预售标记预售商品不能直接扣现货库存限购字段limitPurchase订单系统做下单数量拦截降级逻辑接口超时使用 Redis 缓存旧数据记录告警日志禁止直接拒绝下单注意该接口库存为区域可售库存不是全国总库存area 必须设置为业务发货地区编码稀土掘金。场景 4反向海淘 / 集运代购系统mulebuy/superbuy 同类系统业务目标海外用户选购京东商品前端展示商品详情、价格、库存、包邮标签。需要字段title、imageList、priceInfo、logisticsInfo、attributeList、skuList落地逻辑前端展示时做币种转换 CNY→外币isFreeShipping京东包邮标签作为系统展示标签注意京东包邮不等于可以直接发海外SKU 选择器完全复用接口返回 skuList用户提交代购订单前实时调用接口校验该 SKU 是否可售优化商品详情页首次加载读取 Redis 缓存仅下单动作实时请求 API风险京东自营部分商品仅支持国内配送接口无法直接返回海外可配送标记业务层需要维护黑名单表过滤不能集运商品。场景 5AI 智能选品系统供应链数据分析业务目标批量挖掘类目爆款按月销、价格区间、好评、库存筛选潜力货源。需要字段salesInfo、priceInfo、category、stockInfo、attributeList落地逻辑搭配京东搜索接口拿到类目下 skuId 列表循环调用 jd.item.get 拿到每个商品结构化数据入库 MySQL筛选规则示例月销 500、库存 100、价格区间过滤输出候选货源结合评论 API 做差评率辅助筛选性能优化尽可能使用批量接口jd.items.batch.get一次最多 50 个 SKU降低请求次数非实时数据分析任务放在凌晨低峰执行避开大促高峰期。场景 6比价小程序、导购平台业务目标展示京东商品价格、活动给用户做比价参考。建议优先评估联盟接口jd.union.open.goods.detail.query自带佣金和推广链接jd.item.get 落地要点不要高频刷取用户访问触发优先读缓存对外展示必须标注数据来源京东限制该接口不直接返回 CPS 佣金如需推广链路必须再调用联盟接口获取推广 url。场景 7商品舆情分析配套数据源评论舆情系统前置业务目标商品基础元数据绑定评论接口做竞品口碑监控。需要字段skuId、title、brand、category、shopInfo落地逻辑jd.item.get 拿到商品基础元信息调用京东评论 API 获取评论集合将品牌、类目、店铺标签附加到每条评论做 AI 舆情、差评预警缓存策略商品基础元信息缓存 24h无需随评论同步刷新。场景 8自建商城 / 内部供应链中台业务目标把京东作为货源池内部商城展示商品用于企业采购、内部选品。落地要点图片全部转存自有存储防盗链area 配置业务实际采购地区价格不要直接透传京东价格业务层叠加加价规则库存仅作参考下单前实时校验不能完全依赖接口库存做扣减。