京东商品详情API能力解析与标准化应用方案(含JSON返回示例)

前言

一、接口简介

京东商品详情API是京东官方标准化数据接口,为电商服务商、ERP系统、选品工具、导购平台、铺货系统提供合规、稳定的商品结构化数据能力。开发者通过传入商品SKU,即可一次性获取京东商品完整详情数据,替代传统爬虫采集,数据规范、更新实时、稳定性高。

基础调用规范

  • 请求方式:POST

  • 返回格式:标准 JSON

  • 鉴权方式:appKey + appSecret 签名校验

  • 核心入参:skuId(商品唯一编码)

二、核心应用场景

该接口覆盖绝大多数京东电商数字化业务,是无货源、精品运营、CPS分销的底层数据支撑:

  • 商品数据采集与跨平台铺货:自动抓取标题、图片、参数、SKU规格,实现一键商品搬家上架

  • 价格与库存实时监控:定时同步货源售价、券后价、库存状态,避免亏损、超卖

  • 大数据选品分析:依托销量、好评率、价格区间筛选优质货源

  • CPS导购与分销推广:获取佣金比例、优惠券、到手价,搭建带货体系

  • ERP供应链管理:实现京东货源标准化入库、自动调价、自动上下架

三、标准成功返回 JSON 示例(精简完整版)

{ "jd_union_open_goods_detail_query_response": { "code": "0", "msg": "success", "requestId": "req_2026072014080012", "result": { "goodsInfo": { "skuId": "100065474274", "title": "夏季纯棉宽松短袖女 纯色百搭基础T恤多色可选", "brandName": "简禾", "categoryName": "女装 > T恤", "shopName": "简禾官方旗舰店", "isJdSelf": false, "itemUrl": "https://item.jd.com/100065474274.html", "priceInfo": { "originalPrice": "79.90", "discountPrice": "59.00" }, "couponInfo": { "couponDiscount": "10.00", "finalPrice": "49.00", "couponDesc": "满59减10" }, "commissionInfo": { "commissionRate": "12.50", "commissionMoney": "6.13" }, "salesInfo": { "monthSales": 2360, "totalSales": 9650 }, "stockInfo": { "totalStock": 460, "isSale": true }, "imageInfo": { "mainImg": "https://img.jd.com/imgextra/i1/main.jpg", "detailImgList": [ "https://img.jd.com/imgextra/i1/detail_01.jpg", "https://img.jd.com/imgextra/i1/detail_02.jpg" ] }, "skuList": [ { "skuId": "10006547427401", "specText": "白色 M", "skuPrice": "59.00", "skuStock": 180 }, { "skuId": "10006547427402", "specText": "黑色 XL", "skuPrice": "59.00", "skuStock": 125 } ], "productParams": [ {"name":"面料","value":"100%纯棉"}, {"name":"版型","value":"宽松"}, {"name":"季节","value":"夏季"} ], "commentSummary": { "goodRateShow": "96.5", "commentCount": 1420 } } } } }

四、核心字段说明(精简)

  • 基础信息:商品SKU、标题、品牌、类目、店铺、自营标识、商品链接

  • 价格体系:原价、售价、优惠券、券后到手价(用于比价、防亏损)

  • 分销数据:佣金比例、预估佣金(CPS带货核心)

  • 销售口碑:月销量、总销量、好评率(选品评分依据)

  • 库存状态:总库存、是否在售(防超卖、自动下架)

  • 素材图片:主图、详情图数组(铺货、素材采集)

  • SKU规格:各颜色尺码价格、库存(精细化同步)

  • 商品参数:材质、属性、规格参数(商品结构化上架)

五、常见异常返回示例

1. 请求限流

{ "jd_union_open_goods_detail_query_response": { "code": "429", "msg": "请求过于频繁", "requestId": "req_2026072014081111" } }

2. 商品失效/下架

{ "jd_union_open_goods_detail_query_response": { "code": "400", "msg": "skuId不存在或商品已下架" } }

六、接入优势总结

京东商品详情API具备合规稳定、字段全面、结构统一、实时性强四大优势,可一站式解决京东货源选品、铺货、价格监控、库存同步、导购分销等业务难题。相比爬虫采集,官方接口无封禁风险、数据一致性高,是电商SaaS系统与自动化运营工具的标准对接方案。

相关推荐
aiotto资源分享3 天前
Python 写 JSON 文件,程序中途退出会留下什么?
java·python·json·jsondecodeerror
一起学安全技术4 天前
拆大模型 10|结构化输出:让模型返回数据,而不是一段话
人工智能·语言模型·json
用户298698530144 天前
在 Python 中把 Word 文档转换为 JSON 的三种实现方式
python·json·api
FRing036 天前
vue2干货总结10(json-server、vant-ui、postcss插件、axios二次封装、图形验证码、toast轻提示)
开发语言·前端·vue.js·ui·json·vue2·postcss
用户298698530146 天前
使用 Python 将 JSON 转换为 Word 文档的实践指南
python·json·api
九英里路6 天前
protobuf快速上手
网络·c++·中间件·json·谷歌·序列化·protobuf
wuyk5557 天前
Spider-第09讲-三格式落盘CSV-Excel-JSON
爬虫·python·json·excel
wuyk5558 天前
Spider-第07讲-JSON接口与正则提取
爬虫·python·json
xbzb11 天前
镜像到底存在哪:/var/lib/docker 的四级映射与 daemon.json 配置
docker·容器·json·镜像·daemon.json·四级
坤坤子吖11 天前
Linux网络编程:自定义应用层协议与 JSON 序列化
linux·服务器·网络·c++·笔记·json