驗證與存取權
取得 API 存取權
API 存取需要符合資格的 Ecomblade 方案。建立金鑰，在顯示時儲存 secret，並以 Bearer token 傳送。
GET
/api/v1/products/search商品搜尋 · platform, query, country, page=1, filters?GET
/api/v1/products/category類目商品 · platform, categoryId, country, categoryLevel=2, page=1請求範例
curl --get 'https://api.ecomblade.com/api/v1/products/search?platform=shopee&query=wireless+earbuds&page=1&country=SG' \
--header 'Authorization: Bearer $ECOMBLADE_API_KEY'API 傳回的數據
回應範例
回應包含標準化商品欄位和平台專屬數據，例如商品識別碼、URL、圖片、價格、貨幣、評分、銷量、營收及可用的店舖資訊。
JSON
{
"success": true,
"data": {
"status": 200,
"items": [
{
"itemId": "10001234567",
"name": "Wireless Noise-Cancelling Earbuds",
"slug": "wireless-noise-cancelling-earbuds-i.500123456.10001234567",
"url": "https://shopee.sg/wireless-noise-cancelling-earbuds-i.500123456.10001234567",
"brand": "Example Audio",
"image": "https://cf.example.com/file/example-earbuds",
"shopId": "500123456",
"shopName": "Example Audio Official",
"price": 39.9,
"originalPrice": 52.9,
"discount": 24,
"currency": "SGD",
"sold": 1280,
"monthlySold": 340,
"totalSold": 4620,
"revenue": 51072,
"monthlyRevenue": 13566,
"totalRevenue": 184338,
"listingDate": "2026-01-15T00:00:00.000Z",
"reviews": 894,
"marketplaceData": {
"shopee": {
"rating": 4.8,
"like": 1200,
"comment": 415,
"stock": 680,
"stockValue": 27132,
"location": "Singapore"
}
}
}
],
"hasFullAccess": true,
"isLimited": false
}
}實用平台訊號
回應包含標準化商品欄位和平台專屬數據，例如商品識別碼、URL、圖片、價格、貨幣、評分、銷量、營收及可用的店舖資訊。
錯誤與使用限制
無效參數或憑證、方案權限、rate limit、上游處理和分頁結束都會傳回明確的 HTTP 錯誤。客戶端應檢查狀態並遵守 Retry-After。
常見問題
哪些端點支援 Shopee？
GET /api/v1/products/search 和 GET /api/v1/products/category 均支援 Shopee。
哪個 country 值用於選擇新加坡？
使用 country=SG。此平台必須提供 country 參數。