一、接口概述
item_get_pro是淘寶開放平臺提供的核心接口，用于獲取淘寶 / 天貓商品的詳細信息，包括基礎屬性、價格、庫存、銷量、評價、賣家信息等。適用于電商分析、比價工具、數(shù)據(jù)監(jiān)控等場景。
核心功能：
- 獲取商品基本信息（標題、價格、庫存、銷量）。
- 提取商品屬性（顏色、尺碼、材質）及 SKU 規(guī)格。
- 解析賣家信息（店鋪名稱、信譽、聯(lián)系方式）。
- 獲取促銷信息（優(yōu)惠券、限時折扣）及歷史價格。
- 支持多維度數(shù)據(jù)字段篩選，減少冗余傳輸。
二、使用流程
- 必選參數(shù)：請求地址: 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，將調用緩存的數(shù)據(jù)，速度比較快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回數(shù)據(jù)格式，默認為json，jsonu輸出的內(nèi)容中文可以直接閱讀 |
| lang | String | 否 | [cn,en,ru]翻譯語言，默認cn簡體中文 |
| version | String | 否 | API版本 |
三. 發(fā)送請求與解析響應
- 請求響應示例（JSON）：
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請求示例 url 默認請求參數(shù)已經(jīng)做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秒，需根據(jù)業(yè)務申請?zhí)嵘漕~。
- 字段篩選：使用
fields參數(shù)按需獲取字段，減少數(shù)據(jù)量。 - 錯誤處理：
- 解析
error_response字段（如code：錯誤碼，msg：錯誤信息）。 - 常見錯誤：
Invalid signature（簽名錯誤）、Insufficient permissions（權限不足）。 - 數(shù)據(jù)更新：
- 商品信息實時更新，大促期間建議增加重試機制。
- 緩存非敏感數(shù)據(jù)（如商品描述），降低接口調用頻率。
五、應用場景
- 電商分析：監(jiān)控競品價格、銷量及庫存變化。
- 比價工具：整合多平臺數(shù)據(jù)，提供實時價格對比。
- 商品管理：同步淘寶商品信息至自有平臺（標題、圖片、SKU）。
- 用戶服務：在 APP / 網(wǎng)站中展示淘寶商品詳情（需標注來源）。
6、接口資源
- 接口文檔：淘寶平臺 -商品詳情接口
- SDK 下載：支持 Java、Python、PHP 等語言，簡化簽名與請求處理。
通過合理使用item_get接口，開發(fā)者可高效獲取淘寶商品核心數(shù)據(jù)，結合業(yè)務場景構建智能電商應用。建議定期關注接口更新（如字段新增、權限調整），確保服務穩(wěn)定性。
