Tìm Kiếm & Gắn Nhạc Bản Quyền TikTok

Thuật toán TikTok ưu tiên rất lớn cho các video sử dụng âm thanh chính thức hoặc bài hát đang thịnh hành (Trending Sounds). Việc chèn bài hát bản quyền vào video bằng StackVid API giúp video của bạn tránh bị tắt tiếng (Mute audio) khi đăng tải.

---

1. Tìm Kiếm Nhạc Theo Từ Khóa (POST /api/tiktok/music/search)

• Endpoint: POST /api/tiktok/music/search
• Chi phí Credit: 1 Credit / 1 lượt tìm kiếm.

Tham Số Payload:

{
  "keyword": "see tinh remix",
  "cursor": 0,
  "count": 10,
  "onlyCommerce": true
}

• keyword (String, Bắt buộc): Từ khóa bài hát, nghệ sĩ hoặc tên giai điệu cần tìm.
• count (Number, Tùy chọn, Mặc định: 20): Số lượng bài hát trả về (tối đa 50).
• cursor (Number, Tùy chọn, Mặc định: 0): Vị trí phân trang cursor.
• onlyCommerce (Boolean, Tùy chọn, Mặc định: false): Lọc chỉ lấy nhạc có bản quyền thương mại (isCommerceMusic: true).

Cực Kỳ Quan Trọng Khi Gắn Giỏ Hàng TikTok Shop

Khi video có gắn link sản phẩm hoặc giỏ hàng TikTok Shop, chính sách của TikTok bắt buộc bài đăng phải sử dụng âm thanh thương mại (Commercial Music). Nếu bạn sử dụng bài hát thông thường, TikTok sẽ tự động tắt tiếng (mute) video sau khi đăng. Hãy luôn đặt "onlyCommerce": true khi tìm kiếm nhạc cho các video bán hàng hoặc affiliate!

---

Code Mẫu Tìm Kiếm:

cURL

curl -X POST https://api.stackvid.dev/api/tiktok/music/search \
  -H "X-API-Key: tk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "remix trending",
    "count": 5,
    "onlyCommerce": true
  }'

Node.js

import axios from 'axios';

const musicRes = await axios.post(
  'https://api.stackvid.dev/api/tiktok/music/search',
  {
    keyword: 'remix trending',
    count: 5,
    onlyCommerce: true,
  },
  {
    headers: { 'X-API-Key': 'tk_live_YOUR_API_KEY' },
  }
);

console.log('Kết quả tìm kiếm nhạc:', musicRes.data);

Python

import requests

resp = requests.post(
    'https://api.stackvid.dev/api/tiktok/music/search',
    headers={'X-API-Key': 'tk_live_YOUR_API_KEY'},
    json={
        'keyword': 'remix trending',
        'count': 5,
        'onlyCommerce': True
    }
)

print(resp.json())

Response Mẫu:

{
  "music_list": [
    {
      "id": "7189283746591028374",
      "title": "See Tình (Remix)",
      "author": "Hoàng Thùy Linh",
      "duration": 60,
      "play_url": "https://sf16-ies-music.tiktokcdn.com/...",
      "user_count": 894000,
      "isCommerceMusic": true
    }
  ],
  "has_more": true,
  "cursor": 5
}

---

2. Gắn Nhạc Bản Quyền Vào Bài Đăng

Khi đã có id của bản nhạc mong muốn (ví dụ: "7189283746591028374"), bạn chỉ cần truyền vào trường soundId khi gọi API đăng video:

{
  "videoUrl": "https://cdn.yourdomain.com/videos/summer-fashion.mp4",
  "text": "Video chill cùng giai điệu trending! #music #trending",
  "soundId": "7189283746591028374"
}

Hệ thống sẽ tự động liên kết thẻ bài hát của TikTok vào video vừa đăng, giúp video hiển thị đĩa nhạc ở góc dưới màn hình và tăng tối đa cơ hội phân phối trên trang xu hướng (For You Page).