你想通过 Python 快速实现京东商品详情 API 的调用，完成商品信息抓取，我会基于京东开放平台的合规 API（或新手友好的第三方 API），提供「零基础可落地、代码极简、步骤清晰」的入门方案，涵盖从 API 准备到数据解析的全流程，避开京东 API 的核心入门坑点。
一、核心前提（入门必看）
- API 选择 ：
- 新手推荐：第三方开放平台 API（如聚合数据、易源数据），无需企业资质，免费试用，上手快；
- 合规进阶：京东开放平台 API（需企业资质、申请应用、签约接口），适合生产环境；
- 核心流程 ：
API密钥申请 → 构造请求参数 → 发送HTTP请求 → 解析JSON响应 → 提取商品数据； - 必备库 ：
requests（发送 HTTP 请求）、json（解析 JSON 数据），均为 Python 内置 / 主流库，新手易掌握。
二、前置准备
1. 安装依赖库
仅需安装requests（Python3.6 + 自带，若缺失则执行以下命令）：
bash
运行
pip install requests2. 获取第三方京东商品详情 API 密钥
以「聚合数据」为例（新手首选，免费试用）：
- 关注博主，搜索「京东商品详情」；
- 免费领取 API 接口，完成实名认证，获取
AppKey（核心调用密钥）； - 查看接口文档，确认核心信息：
- 请求地址：
https://v.juhe.cn/jd/item/detail； - 请求方式：GET；
- 必填参数：
key（AppKey）、sku_id（京东商品 ID，从商品 URL 提取，如https://item.jd.com/100060195820.html中的100060195820）； - 响应格式：JSON，包含商品标题、价格、库存、销量等核心字段。
- 请求地址：
三、完整入门代码（可直接运行）
python
运行
import requests
import json
# ===================== 配置信息（替换为你的信息） =====================
APP_KEY = "你的聚合数据AppKey" # 替换为自己的AppKey
SKU_ID = "100060195820" # 京东商品ID（可替换为任意商品ID）
API_URL = "https://v.juhe.cn/jd/item/detail"
# ====================================================================
def get_jd_item_detail():
"""抓取京东商品详情核心信息"""
# 1. 构造请求参数
params = {
"key": APP_KEY,
"sku_id": SKU_ID
}
# 2. 构造请求头（模拟浏览器，避免被拦截）
headers = {
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
}
try:
# 3. 发送GET请求（超时时间5秒，避免卡顿）
response = requests.get(API_URL, params=params, headers=headers, timeout=5)
# 4. 检查请求状态（200表示成功）
if response.status_code == 200:
# 5. 解析JSON响应
result = response.json()
# 6. 判断API调用是否成功（聚合数据：error_code=0为成功）
if result["error_code"] == 0:
# 7. 提取核心商品信息（逐层解析JSON）
item_data = result["result"]
detail = {
"商品ID": item_data["sku_id"],
"商品标题": item_data["title"],
"商品价格": f"{item_data['price']}元",
"库存状态": item_data["stock_state"],
"店铺名称": item_data["shop_name"],
"商品主图": item_data["pic_url"],
"销量": item_data.get("sales", "暂无数据") # 部分商品无销量，用get避免KeyError
}
# 8. 打印结果（格式化输出，更清晰）
print("=== 京东商品详情 ===")
for key, value in detail.items():
print(f"{key}：{value}")
# 可选：将数据保存为JSON文件
with open("jd_item_detail.json", "w", encoding="utf-8") as f:
json.dump(detail, f, ensure_ascii=False, indent=4)
print("\n商品数据已保存到 jd_item_detail.json 文件")
else:
print(f"API调用失败：{result['reason']}，错误码：{result['error_code']}")
else:
print(f"HTTP请求失败，状态码：{response.status_code}")
except requests.exceptions.Timeout:
print("请求超时：京东API响应过慢，请稍后重试")
except requests.exceptions.ConnectionError:
print("网络错误：请检查网络连接或API地址是否正确")
except KeyError as e:
print(f"数据解析失败：缺失字段 {e}，可能是商品ID无效或API返回格式变更")
except Exception as e:
print(f"未知错误：{str(e)}")
if __name__ == "__main__":
get_jd_item_detail()四、代码核心说明（新手友好）
1. 关键步骤拆解
表格
| 步骤 | 代码核心 | 作用 |
|---|---|---|
| 1 | params构造参数 |
传入 AppKey 和商品 ID，是 API 调用的必备条件 |
| 2 | headers设置 User-Agent |
模拟浏览器请求，避免第三方 API 拦截（新手最易踩的坑） |
| 3 | requests.get()发送请求 |
超时时间设为 5 秒，避免程序无限等待 |
| 4 | response.status_code |
先判断 HTTP 请求是否成功，再解析数据 |
| 5 | response.json() |
将 JSON 字符串转为 Python 字典，方便提取数据 |
| 6 | result["error_code"] |
第三方 API 的通用成功标识，非 0 则直接提示失败原因 |
| 7 | 提取核心字段 | 仅保留新手最关心的标题、价格、库存等，避免复杂解析 |
| 8 | 异常捕获 | 覆盖超时、网络、字段缺失等常见异常，新手不会因小错误卡壳 |
2. 核心坑点规避
- User-Agent 缺失：不设置请求头会被 API 拦截，返回「请求非法」，代码中已默认配置；
- KeyError 异常 ：部分商品无销量字段，用
item_data.get("sales", "暂无数据")替代直接取值； - 商品 ID 无效：若提示「商品不存在」，检查 SKU_ID 是否从商品 URL 正确提取（京东商品 ID 为纯数字）；
- AppKey 错误：提示「APPKEY 不存在」时，核对聚合数据的 AppKey 是否复制正确（注意前后无空格）。
五、运行结果示例
plaintext
=== 京东商品详情 ===
商品ID：100060195820
商品标题：京东京造 轻量便携保温杯 350ml 白色
商品价格：99.9元
库存状态：有货
店铺名称：京东京造官方旗舰店
商品主图：https://img10.360buyimg.com/n1/jfs/t1/21628/19/26077/44379/649a7f30F8040d770/xxx.jpg
销量：10万+
商品数据已保存到 jd_item_detail.json 文件六、进阶扩展（新手可选）
1. 批量抓取多个商品
只需将 SKU_ID 改为列表，循环调用即可：
python
运行
# 批量商品ID
sku_list = ["100060195820", "100080907904", "100095380451"]
for sku in sku_list:
print(f"\n===== 开始抓取商品 {sku} =====")
SKU_ID = sku # 替换当前商品ID
get_jd_item_detail()2. 解析更多字段
若需要库存数量、发货地、商品规格等，可在detail字典中添加对应字段：
python
运行
detail = {
# 原有字段...
"库存数量": item_data["stock_num"],
"发货地": item_data["delivery_place"],
"商品规格": item_data["spec_info"]
}总结
- 核心逻辑：京东商品详情抓取的入门核心是「构造请求参数 → 发送请求 → 解析 JSON 核心字段」，代码仅 30 + 行即可完成；
- 关键配置 ：必须设置
User-Agent、核对AppKey和SKU_ID，这是新手最易出错的 3 个点； - 异常处理：覆盖超时、网络、字段缺失等异常，保证程序稳定运行；
- 扩展方向：批量抓取、解析更多字段、保存到 Excel，均可基于入门代码快速扩展。
这套方案完全适配新手，无需复杂的 API 签名、加密等操作，复制代码替换配置即可运行，是快速掌握京东商品详情 API 的最佳入门方式。