淘宝商品详情 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 接口
- 解决签名错误、无数据、报错等问题