淘宝/天猫商品详情原数据API(如颜色、尺寸、材质等属性)的获取,需通过官方开放平台或合规第三方服务实现,不支持直接从App端逆向抓取。以下是完整技术方案:
官方API接入方案(合规首选)
核心接口
接口名称:taobao.item.get(通用)或 taobao.item_get_app(APP端原数据)
请求方式:HTTPS GET/POST
认证机制:AppKey + AppSecret + 签名(HMAC-SHA256)
调用前提:
注册淘宝开放平台开发者账号
完成企业实名认证
创建应用并申请 taobao.item.get 权限(个人开发者权限受限)
商品属性字段结构
商品的颜色、尺寸、材质等属性,统一通过 props 字段以键值对数组形式返回:
json
{
"item": {
"title": "纯棉男士T恤",
"price": 89.00,
"props": [
{
"name": "颜色",
"value": "黑色"
},
{
"name": "尺寸",
"value": "L"
},
{
"name": "材质",
"value": "100%棉"
},
{
"name": "袖长",
"value": "短袖"
}
]
}
}
✅ 关键字段说明:
props:属性列表,每个元素为 {name, value} 对
name:属性名称(如“颜色”)
value:属性值(如“黑色”)
可通过 fields 参数指定返回字段,如 fields=title,price,props 以减少响应体积
调用示例(Python)
python
import requests
import hashlib
import time
APP_KEY = "your_app_key"
APP_SECRET = "your_app_secret"
NUM_IID = "123456789"
params = {
"method": "taobao.item.get",
"app_key": APP_KEY,
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"format": "json",
"v": "2.0",
"num_iid": NUM_IID,
"fields": "title,price,props"
}
# 签名生成(简化示例,实际需按官方算法)
sign_str = "".join([f"{k}{v}" for k, v in sorted(params.items())]) + APP_SECRET
params["sign"] = hashlib.md5(sign_str.encode()).hexdigest()
url = "https://eco.taobao.com/router/rest"
response = requests.get(url, params=params)
data = response.json()
print(data["item"]["props"])
⚠️ 注意:签名算法需严格遵循淘宝开放平台文档,否则请求失败。
第三方API服务方案(快速落地)
若企业或个人无法通过官方审核,可使用合规封装的第三方API服务,如:
表格
服务商 接口地址 特点 适用场景
onebound.cn https://api-gw.onebound.cn/taobao/item_get 无需淘宝账号、一键调用、返回完整props 电商选品、比价系统、小程序展示
阿里云市场 无有效商品详情API — 不推荐
其他服务商 多数为onebound等代理 需验证数据稳定性与合规性 短期项目、非核心业务
✅ 第三方服务优势:
无需复杂签名
支持JSON/CSV返回
提供Python/Java/PHP SDK
支持缓存控制(cache=yes/no)
按次计费,失败不扣费
禁止行为与风险提示
❌ 禁止使用爬虫、逆向工程:违反《淘宝平台服务协议》,可能导致IP封禁、账号冻结、法律追责。
❌ 禁止数据倒卖或批量采集:违反《个人信息保护法》及《电子商务法》。
✅ 合规建议:
优先使用官方API(企业资质完备)
次选可信第三方(有备案、有售后)
所有调用需记录日志,遵守QPS限制(官方默认≤10次/秒)
开发者资源推荐

