API tìm kiếm nhạc TikTok (Music Search)¶

Tổng quan¶

Tìm nhạc / sound TikTok theo từ khóa. Response: keyword, items[] (music_id, title, author, music_url, cover_url, link, duration giây), cursor, has_more.

Giá cả¶

5 credits cho mỗi yêu cầu

Chi phí cố định mỗi lần gọi.

Endpoint¶

URL: https://api.revidapi.com/paid/tiktok/music/search
Method: POST

Tham số gửi kèm query string trên URL (cùng kiểu các endpoint POST .../paid/... khác).

Yêu cầu¶

Headers¶

x-api-key: Bắt buộc. Lấy key tại revidapi.com.

Query parameters¶

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
`keyword`	string	Có	—	Từ khóa tìm kiếm
`offset`	string	Không	`0`	Bắt đầu từ `0`; trang 2+ lấy giá trị `cursor` trong response trước gán vào `offset` để gọi tiếp
`count`	int	Không	`20`	Số lượng kết quả; không vượt quá 20
`filter_by`	int	Không	`0`	`0` = Tất cả (All), `1` = Tiêu đề (Title), `2` = Tác giả (Author)
`sort_type`	int	Không	`0`	`0` = Liên quan; `1` = Dùng nhiều nhất; `2` = Mới nhất; `3` = Ngắn nhất; `4` = Dài nhất
`region`	string	Không	`US`	Vùng (mặc định `US` = Mỹ). Mã TikTok region hoặc ISO 3166-1 alpha-2 (vd. `VN` = Việt Nam)

Ví dụ (thị trường Việt Nam)¶

Tìm nhạc nền viral theo từ khóa tiếng Việt (VN)¶

curl -X POST "https://api.revidapi.com/paid/tiktok/music/search?keyword=nhạc%20nền%20tiktok&offset=0&count=20&filter_by=0&sort_type=0&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Lọc theo tiêu đề, sắp xếp dùng nhiều nhất¶

curl -X POST "https://api.revidapi.com/paid/tiktok/music/search?keyword=remix%20việt&offset=0&count=15&filter_by=1&sort_type=1&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Trang tiếp theo (dùng `cursor` từ response trước làm `offset`)¶

curl -X POST "https://api.revidapi.com/paid/tiktok/music/search?keyword=lofi&offset=CURSOR_FROM_PREVIOUS_RESPONSE&count=20&sort_type=2&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Thay CURSOR_FROM_PREVIOUS_RESPONSE bằng giá trị cursor thực tế từ JSON response lần gọi trước.

Phản hồi¶

Thành công (200)¶

{
  "keyword": "nhạc nền tiktok",
  "items": [
    {
      "music_id": "7629279488405506065",
      "title": "Tên sound",
      "author": "creator",
      "music_url": "https://...",
      "cover_url": "https://...",
      "link": "https://...",
      "duration": 30
    }
  ],
  "cursor": "next_cursor_token",
  "has_more": true
}

Các trường response (điển hình)¶

Trường	Kiểu	Mô tả
`keyword`	string	Từ khóa đã tìm
`items`	array	Danh sách sound
`cursor`	string	Dùng làm `offset` cho request tiếp theo
`has_more`	boolean	Còn trang tiếp theo

Phân trang¶

Lần đầu: offset=0.
Trang sau: copy cursor từ response → gán vào query offset → gọi lại cùng keyword và các filter khác.

Phản hồi lỗi¶

Status	Mô tả
401	Thiếu hoặc sai `x-api-key`
402	Không đủ credits
4xx/5xx	Thiếu `keyword`, `count` > 20, hoặc lỗi upstream

Ghi chú sử dụng¶

count tối đa 20 — không gửi vượt quá.
region=VN khi làm content / ads cho thị trường Việt Nam.
Sau khi có music_id, gọi TikTok Music Download (/paid/tiktok/music/download) để lấy URL stream chi tiết.
Kết hợp Music Trend để đối chiếu sound đang hot trên BXH với kết quả search.