淘宝商品详情数据接口调用指南：Python实现与实战

本文链接：https://blog.csdn.net/2501_91698277/article/details/147454681

一、接口概述

淘宝商品详情接口是淘宝开放平台提供的重要API之一，允许开发者获取商品的详细信息数据。通过该接口，我们可以获取包括商品标题、价格、销量、描述、图片等在内的完整商品数据。

1.1 接口功能

- 获取商品基础信息（标题、价格、销量等）

- 获取商品详情描述（HTML格式）

- 获取商品图片和视频信息

- 获取商品SKU（库存量单位）信息

- 获取商品评价数据

1.2 接口权限

调用淘宝商品详情接口需要申请相应的API权限，通常需要：

1. 注册淘宝开放平台开发者账号

2. 创建应用获取App Key和App Secret

3. 申请相应的API调用权限

二、接口调用准备

2.1 环境准备

在开始调用接口前，需要确保你的开发环境满足以下要求：

```python

# 安装必要的Python库

pip install requests

pip install pycryptodome # 用于签名计算

```

2.2 获取API密钥

1. 登录[淘宝开放平台](淘宝开放平台)

2. 进入"控制台" -> "应用管理"

3. 创建新应用或使用现有应用，获取App Key和App Secret

三、接口调用实现

3.1 基础调用方法

以下是一个基本的淘宝商品详情接口调用示例：


```python

import hashlib

import hmac

import time

import urllib.parse

import requests

def get_taobao_item_detail(app_key, app_secret, item_id):

# 公共参数

params = {

'method': 'taobao.item.get',

'app_key': app_key,

'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),

'format': 'json',

'v': '2.0',

'sign_method': 'hmac',

'num_iid': str(item_id),

'fields': 'num_iid,title,price,pic_url,desc,item_img.url,sku.props_name,sku.quantity,sku.price'

}

# 参数排序

sorted_params = sorted(params.items(), key=lambda x: x[0])

# 构造待签名字符串

query_string = urllib.parse.urlencode(sorted_params)

message = app_secret + query_string + app_secret

# 计算签名

sign = hmac.new(app_secret.encode('utf-8'), message.encode('utf-8'), hashlib.md5).hexdigest().upper()

# 添加签名到参数

params['sign'] = sign

# 发送请求

url = 'https://eco.taobao.com/router/rest'

response = requests.get(url, params=params)

return response.json()

# 使用示例

if __name__ == '__main__':

APP_KEY = '你的AppKey'

APP_SECRET = '你的AppSecret'

ITEM_ID = '商品ID' # 例如: '620901245836'

result = get_taobao_item_detail(APP_KEY, APP_SECRET, ITEM_ID)

print(result)

```

3.2 返回结果解析

接口返回的JSON数据通常包含以下主要字段：


```json

{

"item_get_response": {

"item": {

"num_iid": "620901245836",

"title": "商品标题",

"price": "99.00",

"pic_url": "https://img.alicdn.com/xxx.jpg",

"item_imgs": {

"item_img": [

{

"url": "https://img.alicdn.com/xxx.jpg"

}

]

},

"skus": {

"sku": [

{

"properties_name": "颜色分类:黑色;尺码:M",

"quantity": 100,

"price": "99.00"

}

]

}

}

}

}

```

四、高级应用与优化

4.1 批量获取商品详情

如果需要获取多个商品的详情，可以使用批量接口：

```python

def get_taobao_items_batch(app_key, app_secret, item_ids):

params = {

'method': 'taobao.items.list.get',

'app_key': app_key,

'timestamp': time.strftime('%Y-%m-%d %H:%M:%S'),

'format': 'json',

'v': '2.0',

'sign_method': 'hmac',

'num_iids': ','.join([str(i) for i in item_ids]),

'fields': 'num_iid,title,price,pic_url'

}

# 其余签名和请求代码与单个商品获取类似

# ...

```

4.2 错误处理与重试机制

```python

def safe_get_taobao_item(app_key, app_secret, item_id, retry=3):

for i in range(retry):

try:

result = get_taobao_item_detail(app_key, app_secret, item_id)

if 'error_response' in result:

print(f"API Error: {result['error_response']['msg']}")

if i < retry - 1:

time.sleep(2) # 等待2秒后重试

continue

return None

return result

except Exception as e:

print(f"Request failed: {str(e)}")

if i < retry - 1:

time.sleep(2)

continue

return None

```