jd.item_get 是京东官方提供的商品详情查询接口，可一键获取京东全品类商品的结构化详情数据，支持自营、第三方店铺、京东国际商品查询，是电商开发、数据采集场景的核心工具。下面为你带来完整的实战落地指南。
🔑 前置准备：接口权限申请
注册开发者账号：前往京东开放平台注册开发者身份，完成实名认证。
创建应用：新建应用并提交商品数据相关的接口权限申请，等待平台审核。
获取密钥：审核通过后拿到核心凭证 app_key 和 app_secret，店铺托管场景还需额外申请 access_token。
📋 核心请求参数配置
表格
参数名 类型 必填 说明
app_key String 是 开放平台分配的应用密钥
method String 是 固定值 jd.item.get
timestamp String 是 北京时间 yyyy-MM-dd HH:mm:ss，用于防重放校验
v String 是 接口版本，固定为 2.0
skuId / itemId Long 二选一必填 单品SKU编号/多规格商品主ID，推荐优先用skuId精准查询
sign String 是 MD5大写签名，生成规则：app_secret + 所有参数按key升序拼接 + app_secret 后做MD5加密
fields String 否 按需指定返回字段，逗号分隔，可大幅减少返回包体积
area String 否 地区编码，不传默认返回北京地区的库存、售价数据
🚀 标准请求示例
python
import requests
import hashlib
from urllib.parse import urlencode
# 配置基础凭证
APP_KEY = "你的app_key"
APP_SECRET = "你的app_secret"
API_GATEWAY = "https://api.jd.com/routerjson"
# 构造请求参数
params = {
"app_key": APP_KEY,
"method": "jd.item.get",
"timestamp": "2026-09-02 15:00:00",
"v": "2.0",
"skuId": 100012345678,
"fields": "skuId,title,price,stock,shopInfo,images"
}
# 生成签名
def get_jd_sign(params_dict, app_secret):
sign_str = app_secret
for key in sorted(params_dict.keys()):
sign_str += f"{key}{params_dict[key]}"
sign_str += app_secret
return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
params["sign"] = get_jd_sign(params, APP_SECRET)
# 发送请求
response = requests.post(API_GATEWAY, data=params)
result = response.json()
print(result)
📊 返回数据核心字段解析
code：响应状态码，0 代表调用成功，非0为异常错误码。
data：商品详情主体对象，包含所有核心业务数据。
基础信息：商品标题、当前售价、划线价、近30天销量、总评价数、好评率。
多媒体资源：主图URL、全量轮播图集、商品详情HTML源码。
规格库存：全量SKU列表、各规格单独售价、对应库存数量。
店铺信息：店铺ID、店铺名称、是否京东自营标识。
营销数据：满减规则、优惠券信息、券后最终价、活动生效时间。
⚠️ 实战避坑优化技巧
限流缓存：接口存在单秒频次和每日配额限制，高频场景用Redis缓存商品数据，24小时内重复请求直接读缓存，既提速度又减少调用消耗。
图片处理：返回的图片是京东CDN地址，长期使用建议下载到自有服务器，避免京东调整域名后图片失效。
批量采集：先通过京东搜索接口批量获取品类商品ID，再循环调用详情接口，可快速搭建完整的商品数据库。
异常处理：调用时增加重试机制，遇到字段缺失先核对官方最新文档，及时调整字段映射规则。
🎯 典型落地场景
跨平台ERP系统：自动同步京东全店商品信息，实现库存、价格双向打通。
竞品监控工具：定时抓取竞品价格、销量变动，及时调整运营策略。
CPS导购平台：批量获取商品佣金信息，自动生成结构化导购内容。
选品数据分析：整合品类全量商品数据，辅助选品决策。
