Gắn Link Sản Phẩm TikTok Shop (Product Anchors)

Tính năng Product Anchors cho phép bạn gắn trực tiếp liên kết giỏ hàng sản phẩm (E-commerce Product Showcase) vào video xuất bản lên TikTok. Khi người dùng xem video, một nút mua hàng màu vàng sẽ xuất hiện ở góc dưới bên trái màn hình, dẫn thẳng vào trang chi tiết sản phẩm trên gian hàng TikTok Shop của bạn.

---

1. Lấy danh sách sản phẩm Showcase (POST /api/tiktok/showcase/products)

Trước khi gắn sản phẩm vào video, bạn có thể gọi API để lấy danh mục sản phẩm đang mở bán trên gian hàng TikTok Shop của kênh:

• Endpoint: POST /api/tiktok/showcase/products
• Chi phí Credit: 1 Credit / 1 lần gọi.

Tham Số Payload:

{
  "count": 10,
  "offset": 0,
  "targetChannel": "Kênh Thời Trang Hottrend"
}

• count (Number, Tùy chọn, Mặc định: 10, Tối đa: 50): Số lượng sản phẩm muốn lấy trong 1 trang.
• offset (Number, Tùy chọn, Mặc định: 0): Vị trí bắt đầu phân trang.
• targetChannel (String, Tùy chọn): Tên kênh TikTok sở hữu gian hàng. Nếu bỏ trống, hệ thống sẽ tự động sử dụng Kênh Mặc Định trên Dashboard.

cURL

curl -X POST https://api.stackvid.dev/api/tiktok/showcase/products \
  -H "X-API-Key: tk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "count": 10,
    "offset": 0,
    "targetChannel": "Kênh Thời Trang Hottrend"
  }'

Node.js

import axios from 'axios';

const res = await axios.post(
  'https://api.stackvid.dev/api/tiktok/showcase/products',
  {
    count: 10,
    offset: 0,
    targetChannel: 'Kênh Thời Trang Hottrend',
  },
  {
    headers: { 'X-API-Key': 'tk_live_YOUR_API_KEY' },
  }
);

console.log('Danh sách sản phẩm:', res.data.products);

Response Mẫu:

{
  "success": true,
  "message": "Get Products In Showcase successfully",
  "total": 45,
  "products": [
    {
      "product_id": "1729482910392817",
      "title": "Áo Sơ Mi Lụa Hàn Quốc Cao Cấp",
      "cover": "https://p16-oec-va.ibyteimg.com/tos-maliva-i-oec22/1729482910392817.jpeg",
      "price": "299000"
    }
  ]
}

---

2. Gắn Sản Phẩm Vào Bài Đăng Video

Khi gọi API POST /api/tiktok/upload, bạn truyền mảng anchors chứa thông tin sản phẩm cần gắn:

{
  "videoUrl": "https://cdn.yourdomain.com/videos/summer-outfit.mp4",
  "text": "Mẫu áo sơ mi siêu tôn dáng vừa cập bến! Bấm giỏ hàng bên dưới nha! #tiktokshop",
  "targetChannel": "Kênh Thời Trang Hottrend",
  "anchors": [
    {
      "productId": "1729482910392817",
      "displayName": "Áo Sơ Mi Lụa Hàn Quốc"
    }
  ]
}

• productId (Bắt buộc): Mã ID sản phẩm trên TikTok Shop lấy từ bước 1.
• displayName (Tùy chọn): Tên hiển thị của nút gắn thẻ sản phẩm trên video (tối đa 30 ký tự). Nếu để trống, hệ thống sẽ tự động dùng tiêu đề gốc của sản phẩm.

Lưu Ý Bản Quyền Âm Thanh Khi Gắn Giỏ Hàng

TikTok áp dụng chính sách bản quyền rất nghiêm ngặt đối với video thương mại (Shoppable Videos):

• Nếu video của bạn có gắn giỏ hàng sản phẩm, bắt buộc phải sử dụng âm thanh thương mại (Commercial Music).
• Nếu sử dụng nhạc không có quyền thương mại, TikTok sẽ tự động tắt tiếng (mute audio) video ngay sau khi đăng.
• Khi tìm nhạc qua API POST /api/tiktok/music/search, hãy luôn đặt "onlyCommerce": true để lọc danh sách nhạc an toàn cho giỏ hàng.