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