淘宝商品详情API接入指南

​

一、接口基础信息

接口地址
https://api.taobao.com/router/rest

请求方式
POST（推荐）/GET

数据格式
JSON（默认）

二、核心参数说明

参数名	必选	说明
method	是	固定值：taobao.item.get
item_id	是	目标商品数字ID
fields	是	需返回的字段，如：title,price,pic_url
app_key	是	开发者密钥
sign	是	请求签名
timestamp	是	请求时间戳（格式：yyyy-MM-dd HH:mm:ss）

三、签名生成算法

将所有参数按字母序排序：

params = sorted(params.items())

拼接键值对：

query_str = '&'.join([f"{k}{v}" for k,v in params])

追加App Secret：

raw_sign = query_str + app_secret

SHA256加密：

import hashlib
sign = hashlib.sha256(raw_sign.encode()).hexdigest().upper()

四、请求示例（Python）

import requests
import hashlib
import time

app_key = "YOUR_APP_KEY"
app_secret = "YOUR_SECRET"
item_id = "6789012345"

params = {
    "method": "taobao.item.get",
    "item_id": item_id,
    "fields": "title,price,pic_url,desc",
    "app_key": app_key,
    "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
    "v": "2.0"
}

# 生成签名
sorted_params = sorted(params.items())
query_str = ''.join([f"{k}{v}" for k,v in sorted_params])
raw_sign = query_str + app_secret
sign = hashlib.sha256(raw_sign.encode()).hexdigest().upper()
params["sign"] = sign

# 发送请求
response = requests.post("https://api.taobao.com/router/rest", data=params)
print(response.json())

五、响应结构解析

{
  "item_get_response": {
    "item": {
      "title": "【正品保障】无线蓝牙耳机",
      "price": "199.00",
      "pic_url": "https://img.alicdn.com/xxx.jpg",
      "desc": "< p >商品详细描述HTML< /p >"
    }
  }
}

六、注意事项

频率限制：默认每秒2次请求

字段权限：部分字段需申请特殊权限

错误代码：

7：请求参数缺失

15：无效签名

27：商品不存在

提示：实际开发需遵循淘宝开放平台最新文档，本文示例基于2023年API版本。敏感参数已做脱敏处理，请替换为实际申请值。

​
审核编辑 黄宇