前言

一、接口概述

Shopee 商品詳情 API 接口是 Shopee 平臺為開發者提供的，用于獲取商品詳細信息的接口服務。通過該接口，開發者可以獲取商品的標題、價格、庫存、描述、圖片、規格參數、銷量、評價等詳細信息。這些數據為電商數據分析、商品比價工具開發、店鋪管理系統等應用場景提供了全面支持。

主要功能：

• 精準獲取商品信息：根據商品 ID 精確返回對應商品的詳細信息，避免數據混淆。
• 數據全面性：提供豐富的商品相關信息，涵蓋基本屬性、銷售數據、促銷活動等。
• 實時性：返回的商品信息通常是實時更新的，確保開發者獲取到最新的商品狀態。

使用場景：

• 電商數據分析：通過獲取商品詳情數據，分析市場趨勢、用戶需求、商品競爭情況等。
• 商品比價工具：實時跟蹤競品價格變化，為用戶提供最優購買渠道。
• 店鋪管理系統：同步多平臺庫存，避免超賣，優化運營策略。

二、JSON 數據返回參考

以下是一個典型的 Shopee 商品詳情 API 接口返回的 JSON 數據示例：

	{
	"item": {
	"item_id": 123456789,
	"name": "無線藍牙耳機降噪運動跑步耳機",
	"price": 299.9,
	"currency": "CNY",
	"stock": 50,
	"description": "高清音質，IPX5防水，超長續航30小時，支持藍牙5.0",
	"images": [
	"https://cf.shopee.cn/file/123456789/123456789_123456789.jpg",
	"https://cf.shopee.cn/file/123456789/123456789_123456790.jpg"
	],
	"category_id": 12345,
	"category_name": "消費電子 > 耳機 > 藍牙耳機",
	"seller_info": {
	"shop_id": 987654321,
	"shop_name": "數碼旗艦店",
	"rating": 4.8,
	"follower_count": 15000
	},
	"attributes": [
	{
	"name": "顏色",
	"value": ["黑色", "白色", "藍色"]
	},
	{
	"name": "保修期",
	"value": ["12個月"]
	}
	],
	"shipping_info": {
	"free_shipping": true,
	"shipping_fee": 0,
	"days_to_ship": "3-5天"
	},
	"promotions": [
	{
	"type": "discount",
	"value": "20%",
	"start_time": "2023-10-01 00:00:00",
	"end_time": "2023-10-31 23:59:59"
	}
	],
	"ratings": {
	"count": 450,
	"average": 4.7
	}
	},
	"error": null,
	"request_id": "123e4567-e89b-12d3-a456-426614174000"
	}

三、關鍵字段說明

字段名	類型	描述
item_id	Integer	商品唯一標識 ID。
name	String	商品名稱。
price	Float	商品當前售價（單位由?currency?字段決定）。
currency	String	貨幣代碼（如 CNY、USD 等）。
stock	Integer	庫存數量（-1 表示無限制）。
description	String	商品描述（HTML 格式）。
images	Array	商品圖片 URL 列表。
category_id	Integer	商品所屬分類 ID。
category_name	String	商品所屬分類名稱。
seller_info	Object	店鋪信息（包含店鋪 ID、名稱、評分等）。
attributes	Array	商品屬性（如品牌、型號、顏色等）。
shipping_info	Object	物流信息（是否包郵、運費等）。
promotions	Array	促銷活動信息（如折扣、滿減等）。
ratings	Object	用戶評分數據（總評分、帶圖評價數等）。
error	Object	錯誤信息（如有錯誤時返回）。
request_id	String	請求唯一標識 ID，用于追蹤請求。

四、接口調用注意事項

1. 權限要求：需申請對應 API 權限（如?items:read）。
2. 頻率限制：通常 QPS 限制為 60 次/分鐘，需遵守平臺限流規則。
3. 站點區分：不同國家站點需使用對應的?shop_id?和?partner_id。
4. 數據延遲：部分字段（如庫存）可能存在緩存延遲。
5. 錯誤處理：需檢查 HTTP 狀態碼和返回數據中的?error?字段，確保接口調用的健壯性。

五、應用場景示例

• 商品展示：通過獲取商品詳情，在網站或應用中展示商品的基本信息、圖片、價格等。
• 數據分析：獲取商品的銷量、評價等數據，用于分析商品的市場表現和用戶反饋。
• 庫存管理：實時獲取商品的庫存數量，幫助商家管理庫存。
• 價格比較：獲取商品的價格信息，用于與其他平臺或商家進行價格比較。