API 平台

使用 Shopee 商品數據進行開發

使用限定範圍的 Ecomblade API 金鑰呼叫商品搜尋和類目端點,用於內部工具和分析。

驗證與存取權

取得 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=ID' \
  --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.co.id/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": 475000,
        "originalPrice": 625000,
        "discount": 24,
        "currency": "IDR",
        "sold": 1280,
        "monthlySold": 340,
        "totalSold": 4620,
        "revenue": 608000000,
        "monthlyRevenue": 161500000,
        "totalRevenue": 2194500000,
        "listingDate": "2026-01-15T00:00:00.000Z",
        "reviews": 894,
        "marketplaceData": {
          "shopee": {
            "rating": 4.8,
            "like": 1200,
            "comment": 415,
            "stock": 680,
            "stockValue": 323000000,
            "location": "Jakarta"
          }
        }
      }
    ],
    "hasFullAccess": true,
    "isLimited": false
  }
}

實用平台訊號

回應包含標準化商品欄位和平台專屬數據,例如商品識別碼、URL、圖片、價格、貨幣、評分、銷量、營收及可用的店舖資訊。

錯誤與使用限制

無效參數或憑證、方案權限、rate limit、上游處理和分頁結束都會傳回明確的 HTTP 錯誤。客戶端應檢查狀態並遵守 Retry-After。

可用地區

印度尼西亞

使用國家代碼 ID 存取印度尼西亞的 Shopee 數據。

探索

馬來西亞

使用國家代碼 MY 存取馬來西亞的 Shopee 數據。

探索

菲律賓

使用國家代碼 PH 存取菲律賓的 Shopee 數據。

探索

新加坡

使用國家代碼 SG 存取新加坡的 Shopee 數據。

探索

泰國

使用國家代碼 TH 存取泰國的 Shopee 數據。

探索

越南

使用國家代碼 VN 存取越南的 Shopee 數據。

探索
常見問題
哪些端點支援 Shopee?

GET /api/v1/products/search 和 GET /api/v1/products/category 均支援 Shopee。

取得 API 存取權

選擇符合資格的方案,建立 API 金鑰並將平台數據接入工作流程。

取得 API 存取權無需信用卡。