Nền tảng API

Sử dụng API TikTok Shop cho Việt Nam

Chọn dữ liệu TikTok Shop cho Việt Nam bằng mã quốc gia VN.

Xác thực và quyền truy cập

Nhận quyền truy cập API

API yêu cầu gói Ecomblade đủ điều kiện. Tạo khóa trong Nền tảng API, lưu secret khi hiển thị và gửi dưới dạng Bearer token.

GET/api/v1/products/searchTìm kiếm sản phẩm · platform, query, country, page=1, sort?

GET/api/v1/products/categorySản phẩm theo danh mục · platform, categoryId, country, page=1

Yêu cầu mẫu

curl --get 'https://api.ecomblade.com/api/v1/products/search?platform=tiktok&query=wireless+earbuds&page=1&country=VN' \
  --header 'Authorization: Bearer $ECOMBLADE_API_KEY'

Dữ liệu API trả về

Phản hồi mẫu

Phản hồi gồm trường sản phẩm chuẩn hóa và dữ liệu riêng của sàn như định danh, URL, hình ảnh, giá, tiền tệ, đánh giá, doanh số, doanh thu và cửa hàng khi có.

JSON

{
  "success": true,
  "data": {
    "region": "vn",
    "items": [
      {
        "itemId": "prod-10001",
        "name": "Wireless Noise-Cancelling Earbuds",
        "slug": "wireless-noise-cancelling-earbuds",
        "url": "https://marketplace.example/products/prod-10001",
        "brand": "Example Audio",
        "image": "https://cdn.example.com/products/prod-10001.jpg",
        "shopId": "shop-501",
        "shopName": "Example Audio Official",
        "price": 749000,
        "originalPrice": 999000,
        "discount": 25,
        "currency": "VND",
        "sold": 1280,
        "monthlySold": 340,
        "totalSold": 4620,
        "revenue": 958720000,
        "monthlyRevenue": 254660000,
        "totalRevenue": 3460380000,
        "listingDate": "2026-01-15T00:00:00.000Z",
        "reviews": 894,
        "marketplaceData": {
          "tiktok": {
            "rating": 4.8,
            "like": 920,
            "comment": 415,
            "stock": 680,
            "stockValue": 509320000,
            "location": "Ho Chi Minh City"
          }
        }
      }
    ],
    "hasFullAccess": true,
    "isLimited": false
  }
}

Tín hiệu hữu ích

Lỗi và giới hạn sử dụng

Tham số hoặc thông tin xác thực sai, quyền gói, rate limit, lỗi xử lý nguồn và hết trang đều trả về HTTP error rõ ràng. Hãy kiểm tra trạng thái và tuân thủ Retry-After.

Câu hỏi thường gặp

Điểm cuối nào hỗ trợ TikTok Shop?

GET /api/v1/products/search và GET /api/v1/products/category đều hỗ trợ TikTok Shop.

Giá trị country nào chọn Việt Nam?

Sử dụng country=VN. Tham số country là bắt buộc cho sàn này.

Nhận quyền truy cập API

Chọn gói đủ điều kiện để tạo khóa API và kết nối dữ liệu vào quy trình của bạn.

Nhận quyền truy cập APIKhông cần thẻ tín dụng.