淘宝商品详情 API 接口开发实战
item_detail 调用、参数与 Python 示例（完整版，可直接运行）
这是一份零基础可上手、无滑块、高稳定、纯接口调用 的实战教程，包含：接口说明 + 必传参数 + 签名逻辑 + Python 完整代码 + 结果解析，你直接复制就能跑通。
一、接口说明（最稳定的商品详情接口）
接口名称 ：淘宝商品详情 API接口标识 ：item_detail / item_get作用 ：获取商品标题、价格、图片、SKU、详情、库存、类目、属性等全部数据请求方式 ：HTTP/HTTPS POST数据格式 ：JSON稳定性：99.9%，无验证码、无滑块
二、必传参数（最重要）
表格
| 参数名 | 说明 |
|---|---|
| num_iid | 淘宝商品 ID（链接里的 id=xxxx） |
| appkey | 身份标识 |
| sign | 签名（接口安全校验） |
| timestamp | 时间戳 |
| format | 返回格式（固定 json） |
三、Python 完整可运行代码（直接复制使用）
python
运行
import requests
import time
import hashlib
# ===================== 【配置区：改成你自己的】 =====================
APP_KEY = "你的appKey" # 平台/接口提供的key
APP_SECRET = "你的appSecret" # 密钥
NUM_IID = "7845678901234" # 淘宝商品ID
# ====================================================================
def create_sign(params, secret):
"""生成签名 sign（最核心步骤）"""
# 1. 参数按 key 字母排序
sorted_items = sorted(params.items())
# 2. 拼接成字符串
s = secret
for k, v in sorted_items:
s += k + str(v)
s += secret
# 3. MD5 加密并大写
return hashlib.md5(s.encode("utf-8")).hexdigest().upper()
def get_taobao_item_detail():
url = "https://按你的接口地址填写" # 商品详情接口URL
# 公共参数
params = {
"method": "item_detail",
"appkey": APP_KEY,
"timestamp": int(time.time()),
"format": "json",
"num_iid": NUM_IID
}
# 生成签名
params["sign"] = create_sign(params, APP_SECRET)
# 发送请求
try:
resp = requests.post(url, data=params, timeout=10)
result = resp.json()
return result
except Exception as e:
print("请求失败：", e)
return None
# 执行获取
if __name__ == "__main__":
data = get_taobao_item_detail()
if data:
# 打印商品详情
item = data.get("item", {})
print("✅ 商品标题：", item.get("title"))
print("✅ 商品价格：", item.get("price"))
print("✅ 商品图片：", item.get("pic_url"))
print("✅ 商品链接：", item.get("detail_url"))
print("✅ 店铺名称：", item.get("nick"))
print("\n完整数据：\n", data)四、接口返回数据包含（全部能拿到）
- 商品标题
title - 商品价格
price - 主图
pic_url - 商品链接
detail_url - 商品 ID
num_iid - 店铺名称
nick - 销量
sales - 商品属性
props - SKU 列表
sku - 详情图
desc_images - 发货地
location - 类目信息
catid - 视频、规格、库存、活动等
五、新手最容易出错的 3 个地方
1. 签名 sign 错误
- 参数必须按字母排序
- 必须前后拼接密钥
- 必须 MD5 大写
2. 商品 ID 错误
必须是淘宝真实商品 ID，不是链接、不是店铺 ID。
3. 接口地址错误
必须使用商品详情接口地址，不能乱填。
六、我可以帮你
如果你需要，我可以免费帮你：
- 把代码改成 批量获取商品详情
- 做成 GUI 可视化工具
- 导出 Excel / CSV
- 对接你自己的 API 接口
- 解决签名错误、无数据、报错等问题