在跨境電商電商開發中，獲取商品詳情數據是構建產品展示、價格監控等功能的核心環節。本文將聚焦 eBay 商品詳情接口的實現，詳細介紹如何通過 eBay 的 GetItem API 和 GetMultipleItems 接口獲取完整的商品信息，包括基礎屬性、價格詳情、變體數據、賣家信息等，同時提供可直接復用的 Python 代碼實現。

一、eBay 商品詳情 API 概述

eBay 提供了多個接口獲取商品詳情的 API，其中最常用的是GetItem（獲取單個商品詳情）和GetMultipleItems（批量多個商品詳情），均屬于 Trading API 范疇。

核心特點：

支持獲取完整的商品屬性，包括標題、描述、價格、庫存、物流等

提供豐富的變體商品信息，如不同顏色、尺寸的價格和庫存

包含賣家評分、銷售記錄等商業數據

需要通過 OAuth2.0 認證，支持批量查詢

接口端點：https://api.ebay.com/ws/api.dll

二、核心參數與響應結構

1. 必要參數

ItemID：商品唯一標識符（單個或多個）

IncludeSelector：指定返回字段集合，控制返回數據的詳細程度

MessageID：請求唯一標識，用于追蹤請求

2. 常用 IncludeSelector 值

Details：基本詳情（標題、描述、價格等）

Variations：變體商品信息

Seller：賣家信息

Shipping：物流信息

Taxes：稅費信息

All：返回所有可用字段（不推薦，數據量大）

3. 響應數據結構

響應包含多個層級的數據，核心節點包括：

Item：商品基本信息

Variations：變體商品集合

Seller：賣家詳情

ShippingDetails：物流配置

ItemSpecifics：商品規格參數

點擊獲取key和secret

三、完整代碼實現

以下是獲取 eBay 商品詳情的 Python 實現，支持單個和多個商品查詢，并對返回數據進行結構化處理：

eBay商品詳情接口實現

V1

創建時間：14:24

四、代碼核心功能解析

雙重接口支持：

實現get_single_item方法獲取單個商品詳情

實現get_multiple_items方法批量獲取多個商品，減少 API 調用次數

XML 處理機制：

手動構建 XML 請求體，精確控制請求參數

解析 XML 響應為結構化字典，方便后續處理

封裝多種數據類型轉換方法（整數、浮點數、布爾值等）

變體數據處理：

專門的_parse_variations方法處理變體商品信息

分離變體屬性（如顏色、尺寸）和具體變體項

提取每個變體的價格、庫存和圖片等關鍵信息

完整信息提取：

基礎信息：標題、描述、URL 等

價格信息：當前價、原價、貨幣單位

庫存信息：可用數量、已售數量

賣家信息：ID、評分、好評率

物流信息：運費、處理時間

商品屬性：規格參數鍵值對

五、實戰注意事項

API 權限與限制：

Trading API 需要申請相應權限，部分字段需要額外審核

調用頻率限制：默認每小時 10,000 次請求

單次批量查詢最多支持 20 個商品 ID

數據緩存策略：

商品詳情變化頻率較低，建議緩存 1-24 小時

對熱門商品可縮短緩存時間，保證數據時效性

實現緩存失效機制，處理商品下架等情況

錯誤處理完善：

常見錯誤：商品不存在、權限不足、格式錯誤

建議實現重試機制，處理臨時網絡故障

對返回的錯誤代碼進行解析，提供具體錯誤信息

性能優化建議：

合理使用IncludeSelector參數，只請求需要的字段

批量查詢優先于單個查詢，減少請求次數

實現請求超時控制，避免長期阻塞

六、功能擴展方向

增加商品圖片下載功能，支持主圖和變體圖片

實現商品歷史價格查詢，需要結合 eBay 的 Analytics API

添加商品評價獲取功能，集成 Reviews API

開發商品詳情頁渲染功能，解析 HTML 描述并格式化展示

通過本文提供的方案，開發者可以快速實現 eBay 商品詳情數據的獲取和處理，為跨境電商應用提供豐富的商品信息支持。實際開發中，需遵守 eBay 開發者協議，合理使用獲取的商品數據。

審核編輯 黃宇