TikTok Shop: Tìm Kiếm Hình Ảnh

API cho phép tìm kiếm các sản phẩm tương đồng đang được bán trên sàn TikTok Shop dựa trên dữ liệu ảnh Base64.

---

Thông Tin Endpoint

• Phương thức: POST
• Đường dẫn: /v1/tiktok/search
• Định dạng dữ liệu: Content-Type: application/json
• Xác thực: Header X-API-Key (Yêu cầu quyền truy cập sàn tiktok)

---

1. Tham Số Request Body (JSON)

Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
image_base64	string	Bắt buộc	Chuỗi ảnh mã hóa Base64 thuần túy (không chứa tiền tố data:image/...;base64,)

TIP

Chuẩn hóa chuỗi Base64 trước khi gửi: Nếu chuỗi Base64 của bạn được sinh ra từ trình duyệt dạng Data URL (data:image/jpeg;base64,/9j/4AAQ...), hãy cắt bỏ phần header phía trước:

const cleanBase64 = rawDataUrl.replace(/^data:image\/\w+;base64,/, '');

---

2. Ví Dụ Request

curl -X POST "https://api.yourdomain.com/v1/tiktok/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "image_base64": "/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJ..."
  }'

---

3. Cấu Trúc Response Trả Về

Phản hồi thành công (200 OK) trả về danh sách các sản phẩm tìm thấy trên TikTok Shop:

{
  "code": 0,
  "message": "success",
  "data": {
    "products": [
      {
        "product_id": "17294819284102938",
        "title": "Áo Khoác Bomber Unisex Chống Nước Form Rộng",
        "main_image_url": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/9a8b7c6d5e4f1234567890abcdef.jpg",
        "price": {
          "currency": "VND",
          "real_price": "220000",
          "original_price": "350000"
        },
        "sold_count": 892,
        "seller": {
          "seller_id": "74928194012",
          "shop_name": "Fashion Studio VN"
        }
      }
    ],
    "cursor": 20,
    "has_more": true
  }
}

Ý nghĩa các trường dữ liệu quan trọng:

• product_id: Mã ID định danh sản phẩm trên TikTok Shop.
• title: Tên hiển thị của sản phẩm.
• main_image_url: Đường dẫn URL ảnh đại diện của sản phẩm trên CDN TikTok.
• price.real_price: Giá bán thực tế hiện tại (sau giảm giá/khuyến mãi).
• price.original_price: Giá niêm yết ban đầu.
• sold_count: Số lượng sản phẩm đã bán.
• seller.shop_name: Tên gian hàng bán sản phẩm trên TikTok Shop.
• has_more: true nếu còn sản phẩm ở các trang tiếp theo.
• cursor: Con trỏ phân trang dùng cho request tiếp theo.

---

4. Cách Tạo Link Sản Phẩm TikTok Shop

Để điều hướng người dùng từ ứng dụng của bạn tới trang mua hàng trên TikTok Shop, bạn sử dụng công thức URL sau:

🔗 Công thức Link Sản Phẩm TikTok Shop:

https://shop.tiktok.com/view/product/{product_id}

Ví dụ: Với product_id = 17294819284102938: 👉 https://shop.tiktok.com/view/product/17294819284102938