一、接口概述
item_get_pro是淘宝开放平台提供的核心接口，用于获取淘宝 / 天猫商品的详细信息，包括基础属性、价格、库存、销量、评价、卖家信息等。适用于电商分析、比价工具、数据监控等场景。
核心功能：
- 获取商品基本信息（标题、价格、库存、销量）。
- 提取商品属性（颜色、尺码、材质）及 SKU 规格。
- 解析卖家信息（店铺名称、信誉、联系方式）。
- 获取促销信息（优惠券、限时折扣）及历史价格。
- 支持多维度数据字段筛选，减少冗余传输。
二、使用流程
- 必选参数：请求地址: taobao/item_get_pro
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
| secret | String | 是 | 调用密钥 |
| api_name | String | 是 | API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默认yes，将调用缓存的数据，速度比较快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
| lang | String | 否 | [cn,en,ru]翻译语言，默认cn简体中文 |
| version | String | 否 | API版本 |
三. 发送请求与解析响应
- 请求响应示例（JSON）：
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.onebound.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=652874751412&is_promotion=1"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)四、注意事项
- 请求限制：
- 频率限制：普通应用默认 1 次 / 3-5秒，需根据业务申请提升配额。
- 字段筛选：使用
fields参数按需获取字段，减少数据量。 - 错误处理：
- 解析
error_response字段（如code：错误码，msg：错误信息）。 - 常见错误：
Invalid signature（签名错误）、Insufficient permissions（权限不足）。 - 数据更新：
- 商品信息实时更新，大促期间建议增加重试机制。
- 缓存非敏感数据（如商品描述），降低接口调用频率。
五、应用场景
- 电商分析：监控竞品价格、销量及库存变化。
- 比价工具：整合多平台数据，提供实时价格对比。
- 商品管理：同步淘宝商品信息至自有平台（标题、图片、SKU）。
- 用户服务：在 APP / 网站中展示淘宝商品详情（需标注来源）。
6、接口资源
- 接口文档：淘宝平台 -商品详情接口
- SDK 下载：支持 Java、Python、PHP 等语言，简化签名与请求处理。
通过合理使用item_get接口，开发者可高效获取淘宝商品核心数据，结合业务场景构建智能电商应用。建议定期关注接口更新（如字段新增、权限调整），确保服务稳定性。
