一、接口概述
item_get是淘寶開放平臺提供的核心接口，用于獲取淘寶 / 天貓商品的詳細信息，包括基礎屬性、價格、庫存、銷量、評價、賣家信息等。適用于電商分析、比價工具、數據監控等場景。
核心功能：
- 獲取商品基本信息（標題、價格、庫存、銷量）。
- 提取商品屬性（顏色、尺碼、材質）及 SKU 規格。
- 解析賣家信息（店鋪名稱、信譽、聯系方式）。
- 獲取促銷信息（優惠券、限時折扣）及歷史價格。
- 支持多維度數據字段篩選，減少冗余傳輸。
二、使用流程
- 必選參數：請求地址: taobao/item_get
| 名稱 | 類型 | 必須 | 描述 |
|---|---|---|---|
| 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)四、注意事項
- 請求限制：
- 頻率限制：普通應用默認 50 次 / 分鐘，需根據業務申請提升配額。
- 字段篩選：使用
fields參數按需獲取字段，減少數據量。
- 解析
error_response字段（如code：錯誤碼，msg：錯誤信息）。 - 常見錯誤：
Invalid signature（簽名錯誤）、Insufficient permissions（權限不足）。
- 商品信息實時更新，大促期間建議增加重試機制。
- 緩存非敏感數據（如商品描述），降低接口調用頻率。
五、應用場景
- 電商分析：監控競品價格、銷量及庫存變化。
- 比價工具：整合多平臺數據，提供實時價格對比。
- 商品管理：同步淘寶商品信息至自有平臺（標題、圖片、SKU）。
- 用戶服務：在 APP / 網站中展示淘寶商品詳情（需標注來源）。
6、接口資源
- 接口文檔：淘寶平臺 -商品詳情接口
- SDK 下載：支持 Java、Python、PHP 等語言，簡化簽名與請求處理。
通過合理使用item_get接口，開發者可高效獲取淘寶商品核心數據，結合業務場景構建智能電商應用。建議定期關注接口更新（如字段新增、權限調整），確保服務穩定性。
