Sàn Cam APIs

📦 Sàn Cam Product Data API

Lấy thông tin sản phẩm Sàn Cam kèm chi tiết hoa hồng. Dữ liệu sản phẩm được cache trong database khoảng 3 giờ trước khi làm mới.

Tham số

Ví dụ request

# Khuyến nghị — nhanh nhất
GET https://data.addlivetag.com/product-data/product-data.php?item_id=1589295236

# Khai tier tài khoản của bạn (tuỳ chọn)
GET https://data.addlivetag.com/product-data/product-data.php?item_id=1589295236&base_rate=8&cap=20000

# Hoặc bằng URL / link rút gọn — CHẬM HƠN, nên tự lấy item_id rồi truyền vào
GET https://data.addlivetag.com/product-data/product-data.php?url=https://s.shopee.vn/2VqAMxdjHo

Ví dụ response

{
  "status": "success",
  "productInfo": {
    "itemId": "1589295236",
    "productName": "Tên sản phẩm...",
    "price": 175000,
    "sales": 12345,
    "rating": 4.9,
    "commission": 8750,
    "sellerComFinal": 5250,
    "shopeeComFinal": 3500,
    "isXtra": true,
    "hasSellerCommission": true,
    "hasShopeeCommission": true,
    "isCapped": false,
    "priceStatistics": { ... },
    "dataSource": "api"   // "api" | "db" | "fallback"
  }
}

Hoa hồng được tính thế nào?

• Seller commission: không giới hạn trần, đã áp dụng user rate và thuế.
• Sàn Cam commission: giá trị thô cap tại 50.000 VNĐ, tối đa 4,5% giá sản phẩm.

Giới hạn tốc độ

Chiến lược cache & fallback

• Cache còn hạn → trả từ database (nhanh, giới hạn cao).
• Cache hết hạn → gọi Sàn Cam API và cập nhật cache.
• API lỗi nhưng có dữ liệu cũ → trả bản cache kèm cảnh báo.
• Cả hai nguồn lỗi → response fallback với dữ liệu tối thiểu.

🎁 Sàn Cam Offers API

Bộ 4 API affiliate của Sàn Cam — cache database 30 phút (riêng Shop Products 10 phút), tự fallback bản cache cũ khi API nguồn lỗi.

Tham số chung cho cả 4 endpoint

Hỗ trợ GET/POST, bật CORS. Response chung: status, dataSource ("api" = dữ liệu mới, "db" = từ cache), page / limit / hasNextPage / count, và mảng dữ liệu (offers / products / shops). Khi nguồn tạm lỗi và có bản lưu, thêm stale: true + warning.

1. Sàn Cam Offer — ưu đãi/chiến dịch

GET https://data.addlivetag.com/offers/shopee-offer.php?page=1&limit=10

{
  "status": "success",
  "dataSource": "api",
  "page": 1,
  "limit": 10,
  "hasNextPage": true,
  "count": 10,
  "offers": [
    {
      "name": "Tên chiến dịch...",
      "type": 2,
      "commissionRate": 0.07,
      "image": "https://cf.shopee.vn/file/...",
      "link": "https://shopee.vn/...",
      "startTime": 1750000000,
      "endTime": 1760000000
    }
  ]
}

2. Product Offer — sản phẩm có hoa hồng

GET https://data.addlivetag.com/offers/product-offer.php?keyword=%C3%A1o%20thun&page=1&limit=10

{
  "status": "success",
  "dataSource": "api",
  "page": 1, "limit": 10, "hasNextPage": true, "count": 10,
  "products": [
    {
      "itemId": 43363310862,
      "name": "Áo thun...",
      "link": "https://shopee.vn/product/1608621545/43363310862",
      "image": "https://cf.shopee.vn/file/...",
      "catIds": [100011, 100054],
      "commissionRate": 0.1105,
      "price": 175000,
      "priceMin": 175000,
      "priceMax": 190000,
      "sales": 12345,
      "rating": 4.9,
      "shopId": 1608621545,
      "shopName": "Tên shop...",
      "startTime": 1750000000,
      "endTime": 1760000000
    }
  ]
}

3. Shop Offer — shop/brand có hoa hồng

GET https://data.addlivetag.com/offers/shop-offer.php?keyword=&page=1&limit=10

{
  "status": "success",
  "dataSource": "api",
  "page": 1, "limit": 10, "hasNextPage": true, "count": 10,
  "shops": [
    {
      "shopId": 917660685,
      "name": "Tên shop...",
      "type": [],
      "commissionRate": 0.105,
      "rating": 4.9,
      "remainingBudget": 0,
      "image": "https://cf.shopee.vn/file/...",
      "link": "https://shopee.vn/shop/917660685",
      "startTime": 1761624699,
      "endTime": 32503651199
    }
  ]
}

4. Shop Products — sản phẩm có hoa hồng của một shop

GET https://data.addlivetag.com/offers/shop-products.php?shopId=1608621545&page=1&limit=50

{
  "status": "success",
  "dataSource": "api",
  "shopId": 1608621545,
  "shopName": "Tên shop...",
  "page": 1, "limit": 50, "hasNextPage": true, "count": 50,
  "products": [
    {
      "itemId": 43363310862,
      "name": "Áo thun...",
      "link": "https://shopee.vn/product/1608621545/43363310862",
      "image": "https://cf.shopee.vn/file/...",
      "catIds": [100011, 100054],
      "commissionRate": 0.1105,
      "price": 175000,
      "priceMin": 175000,
      "priceMax": 190000,
      "sales": 12345,
      "rating": 4.9,
      "shopId": 1608621545,
      "shopName": "Tên shop...",
      "startTime": 1750000000,
      "endTime": 1760000000
    }
  ]
}

Giới hạn tốc độ (Offers)