Tài liệu API

API công khai để lấy thông tin và link tải video TikTok. Không cần API Key hay xác thực.

Mô phỏng API (Thử ngay)

Dán link TikTok để gọi thử API và xem kết quả JSON trả về theo thời gian thực.

Base URL

https://download.bonzvip.site

Mọi request đều gửi tới base URL này. Hỗ trợ HTTPS bắt buộc.

Endpoint

POST/api/tiktok/download

Nhận một URL video TikTok và trả về thông tin video cùng link tải MP4 (có và không watermark).

Headers

Header	Giá trị	Bắt buộc	Mô tả
Content-Type	application/json	Có	Định dạng body là JSON

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
url	string	Có	Link video TikTok cần tải. Hỗ trợ các dạng: tiktok.com, vm.tiktok.com, vt.tiktok.com, m.tiktok.com, www.tiktok.com

Response Fields

Trường	Kiểu	Mô tả
success	boolean	Trạng thái thành công. true nếu lấy được thông tin video, false nếu lỗi.
title	string	Tiêu đề video TikTok
author	string	Tên hiển thị của tác giả. Nếu không có nickname sẽ trả về unique_id.
avatar	string	URL ảnh đại diện của tác giả
thumbnail	string	URL thumbnail/cover của video
likes	number	Số lượt thích (digg_count)
views	number	Số lượt xem (play_count)
download_url	string	Link tải MP4 chất lượng cao (không watermark). Nếu không có HD sẽ trả về play_url.
download_url_watermark	string	Link tải MP4 có watermark TikTok
error	string	Thông báo lỗi chi tiết. Chỉ xuất hiện khi success = false.

Ví dụ Request

curl -X POST https://download.bonzvip.site/api/tiktok/download \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@user/video/123456789"}'

Ví dụ Response thành công

JSON · HTTP 200

{
  "success": true,
  "title": "Caption video TikTok",
  "author": "Tên tác giả",
  "avatar": "https://p16-sign-va.tiktokcdn.com/...",
  "thumbnail": "https://p16-sign-va.tiktokcdn.com/...",
  "likes": 12500,
  "views": 340000,
  "download_url": "https://v16-webapp.tiktok.com/.../video.mp4",
  "download_url_watermark": "https://v16-webapp.tiktok.com/.../video_wm.mp4"
}

Ví dụ Response lỗi

JSON · HTTP 400

{
  "success": false,
  "error": "Invalid TikTok URL"
}

JSON · HTTP 502

{
  "success": false,
  "error": "Service unavailable"
}

Mã trạng thái HTTP

HTTP Status	Ý nghĩa	Cách xử lý
200	Thành công	Dữ liệu video đã được trả về. Kiểm tra success = true trước khi sử dụng.
400	Bad Request	URL không hợp lệ, body JSON sai định dạng, hoặc video không tồn tại/bị ẩn. Kiểm tra lại URL và thử lại.
502	Bad Gateway	Lỗi từ nhà cung cấp (TikTok/WMTik) hoặc dịch vụ không khả dụng tạm thời. Thử lại sau vài giây.
500	Internal Server Error	Lỗi máy chủ nội bộ. Liên hệ admin nếu lỗi kéo dài.

Giới hạn sử dụng

Không yêu cầu API Key — API hoàn toàn miễn phí và công khai.
Không có rate limit cứng, nhưng vui lòng không spam request liên tục để tránh bị chặn IP.
Nên giãn cách giữa các request ít nhất 1 giây nếu xử lý hàng loạt.

Lưu ý quan trọng

API không yêu cần API Key hay xác thực.
URL TikTok phải bắt đầu bằng https://tiktok.com/, https://www.tiktok.com/, https://vm.tiktok.com/, v.v.
Link tải (download_url và download_url_watermark) có thời hạn ngắn. Nên tải ngay sau khi nhận response, tối đa trong vòng vài phút.
Nếu video bị xóa, chuyển sang riêng tư, hoặc tài khoản bị khóa, API sẽ trả về lỗi 400.
Chỉ sử dụng cho mục đích cá nhân. Tuân thủ điều khoản sử dụng của TikTok.

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

API có giới hạn số lượng request không?

Hiện tại không có giới hạn cứng, nhưng bạn nên giãn cách request để tránh bị chặn IP.

Link tải có tồn tại bao lâu?

Link tải từ TikTok server thường có thời hạn ngắn (vài phút). Bạn nên tải ngay sau khi nhận response.

Tại sao API trả về lỗi 400 dù URL đúng?

Có thể video đã bị xóa, chuyển sang riêng tư, hoặc tài khoản bị khóa. Hãy kiểm tra lại URL trên trình duyệt.

Có hỗ trợ tải từ TikTok Lite hay TikTok Web không?

Có, miễn là URL thuộc domain tiktok.com (bao gồm vm.tiktok.com, vt.tiktok.com, m.tiktok.com).