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