京东商品详情API是京东开放平台为开发者提供的重要数据接口 ，支持通过商品ID获取多维度商品信息。
一、接口概述
该API能够获取包括商品标题、实时价格、库存状态、销量数据、评价信息、主图/详情图链接 、SKU规格参数以及售后服务条款等120多个字段的详细信息。数据具有分钟级更新的高实时性，确保价格与库存信息的准确性。接口支持批量查询功能，单次获取SKU的商品数据。
公共参数：http://o0b.cn/ibrad
二. 返回核心字段（三个数据）
{
"result": {
"goodsInfo": {
"skuId": "100012345678",
"title": "商品完整标题", // 商品标题
"priceInfo": {
"originalPrice": "199.00", // 原价
"discountPrice": "129.00" // 当前售卖价（重点）
},
"imageInfo": {
"mainImage": "https://img14.img.com/n1/jfs/xxx.jpg", // 主图URL
"imageList": ["图1","图2"] // 多图数组
}
}
}
}title：商品完整标题
priceInfo.discountPrice：实时销售价（促销 / 秒杀会自动更新）
imageInfo.mainImage：商品第一张主图
三、Python 调用示例
import requests, hashlib
from datetime import datetime
app_key = "你的appkey"
app_secret = "你的secret"
sku_id = "100012345678"
# 公共参数
params = {
"method":"jd.union.open.goods.detail.query",
"app_key":app_key,
"timestamp":datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
"v":"1.0",
"format":"json",
"goodsReq":'{"skuId":"%s"}'%sku_id
}
# 生成京东MD5签名
sorted_items = sorted(params.items())
src = app_secret + "".join([k+v for k,v in sorted_items]) + app_secret
sign = hashlib.md5(src.encode()).hexdigest().upper()
params["sign"] = sign
resp = requests.get("https://api.jd.com/routerjson", params=params)
data = resp.json()
# 提取目标字段
goods = data["jd_union_open_goods_detail_query_response"]["result"]["goodsInfo"]
title = goods["title"]
price = goods["priceInfo"]["discountPrice"]
main_img = goods["imageInfo"]["mainImage"]
print("标题：",title)
print("售价：",price)
print("主图：",main_img)四、关键业务要点
SKU 是核心：京东一个 SPU 下会有多个 SKU（不同颜色 / 规格，价格不一样），查询必须传 SKU，不能只用商品 SPU 号。
价格实时性：discountPrice是页面展示实时到手价；遇到大促、优惠券，接口会返回券后价字段。
字段边界 ✅ 商品详情接口：标题、价格、主图 ✅ 原生支持 ❌ 评论总数不在这个详情接口内，评论是独立接口，需要单独调用，需要额外评估工时和调用费用。
QPS & 限流：联盟 API 有调用频率限制，批量采集需要做请求排队、重试、异常捕获；这也是你之前提到的成功率 70%场景，需要切换重试策略、优先 item_get_pro。
该代码实现了京东商品详情API的核心调用功能，包含签名生成和错误处理机制。通过传入商品SKU ID，可以获取包括商品标题、价格、库存等关键信息。
五、技术要点说明
API调用 需要严格遵循签名算法流程，包括按字典序排序参数、拼接参数键值对并进行MD5。返回的JSON数据包含完整的商品信息，开发者可根据需要提取特定字段。
京东商品详情API为电商数据分析、竞品监控、价格追踪等场景提供了可靠的数据支持。其高稳定性和实时性特点使其成为电商开发中的重要工具。在实际应用中，建议结合具体业务需求进行数据字段的筛选和优化。
