京东开放平台提供的标准化 REST 接口，用于获取商品标题、价格、库存、规格等全量详情数据。
接口基础信息
接口名称 jd.item_get 是京东宙斯开放平台提供的核心商品数据接口，支持根据商品 SKU ID 或 Item ID 查询自营/第三方店铺的完整商品元数据。
| 参数 | 说明 |
|---|---|
| 接口名称 | jd.item_get / jd.item.get |
| 传输协议 | HTTPS POST/GET |
| 数据格式 | JSON（默认）/ XML |
| 接口版本 | v2.0 |
| 调用网关 | http://api.jd.com/routerjson |
公共请求参数
所有调用该接口时都必须携带以下公共参数，用于身份认证和请求校验。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 系统与京东平台的商品数据同步
📈
竞品监控分析
监控竞品价格变动、促销策略，辅助商业决策
