京东开放平台提供的标准化 REST 接口，用于获取商品标题、价格、库存、规格等全量详情数据。
接口基础信息
接口名称 jd.item_get 是京东宙斯开放平台提供的核心商品数据接口，支持根据商品 SKU ID 或 Item ID 查询自营/第三方店铺的完整商品元数据。
参数 说明
接口名称 jd.item_get / jd.item.get
传输协议 HTTPS POST/GET
数据格式 JSON（默认）/ XML
接口版本 v2.0
公共请求参数
所有调用该接口时都必须携带以下公共参数，用于身份认证和请求校验。
参数名 类型 必填 说明
app_key String 是 应用密钥，开放平台创建应用获取
method String 是 固定值：jd.item.get
timestamp String 是 北京时间 yyyy-MM-dd HH:mm:ss
v String 是 接口版本，固定 2.0
format String 否 返回格式：json/xml，默认 json
sign String 是 MD5 大写签名
access_token String 否 OAuth 店铺授权令牌
业务入参
用于指定查询的具体商品，支持通过 SKU ID 或 Item ID 进行查询。
参数名 类型 必填 示例 说明
skuId Long 二选一 100012345678 单品 SKU 编号（精准单规格查询，推荐）
itemId Long 1001234567 商品主商品 ID（多 SKU 套装商品入口 ID）
fields String 否 skuId,title,price... 字段过滤，逗号分隔，不传返回全量
返回数据字段
接口返回的商品详情包含以下核心数据模块，可根据业务需求通过 fields 参数按需获取。
基础信息
skuId、title（商品标题）、shortTitle（短标题）、saleState（上下架状态：1上架/0下架）
价格信息
priceInfo 对象包含 marketPrice（市场价）、jdPrice（京东售价）、promotionPrice（促销价）
规格 SKU
skuList 数组包含多规格 SKU 信息，颜色、版本、容量等规格区分
库存信息
stockInfo 对象包含可用库存、是否可售、限购、预售标识
销量评价
salesInfo 对象包含总销量、月销、评价总数、好评率
店铺信息
shopInfo 对象包含店铺 ID、店铺名称、是否京东自营
商品属性
paramList 数组包含材质、尺寸、产地等属性键值对
调用示例 （python）
标准 HTTP POST 请求示例，展示完整的参数拼接方式：
coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from future import print_function
import requests
封装好API demo url=o0b.cn/ibrad
请求示例 url 默认请求参数已经做URL编码
url = "https://api-服务器.cn/jd/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=10335871600&domain_type=jd"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if name == "main":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
适用场景
该 API 广泛应用于以下业务场景：
📊
电商数据监控
实时获取商品价格、库存变化，用于价格策略调整
🔍
商品比价工具
整合多平台商品数据，提供比价服务
🛒
代购系统开发
结合反向海淘代购系统，实现商品信息同步与下单
🏪
ERP 商品同步
支撑 ERP 系统与京东平台的商品数据同步
📈
竞品监控分析
监控竞品价格变动、促销策略，辅助商业决策
