API Platform

Bumuo gamit ang Shopee product data

Tumawag sa product search at category endpoints gamit ang scoped Ecomblade API key para sa internal tools at analysis workflows.

Magsimula nang libre Pangkalahatang-ideya

Authentication at access

Kumuha ng API access

Kailangan ng eligible Ecomblade plan. Gumawa ng key sa authenticated API Platform, itago ang secret, at ipadala bilang Bearer token.

GET/api/v1/products/searchProduct search · platform, query, country, page=1, filters?

GET/api/v1/products/categoryMga produkto sa category · platform, categoryId, country, categoryLevel=2, page=1

Halimbawang request

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'

Data na ibinabalik ng API

Halimbawang response

May normalized product fields at marketplace-specific data ang responses, kabilang ang identity, URLs, images, price, currency, ratings, sales at revenue signals kung available.

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
  }
}

Mahahalagang marketplace signal

May normalized product fields at marketplace-specific data ang responses, kabilang ang identity, URLs, images, price, currency, ratings, sales at revenue signals kung available.

Mga error at usage limit

Nagbabalik ng malinaw na HTTP errors ang invalid parameters, credentials, plan access, rate limits, upstream parsing, at exhausted pages. Suriin ang status at sundin ang Retry-After.

Mga available na rehiyon