API Lấy danh sách video từ TikTok User¶

Tổng quan¶

API này cho phép lấy danh sách video từ TikTok user với hỗ trợ phân trang (cursor qua min_revid / max_revid).

Giá cả¶

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

Chi phí cố định cho mỗi lần tải xuống, bất kể độ dài video hay kích thước tệp.

Endpoint¶

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

Yêu cầu¶

Headers¶

x-api-key: Bắt buộc (nếu API yêu cầu xác thực).

Query parameters¶

Tham số	Kiểu	Bắt buộc	Mô tả
`username`	string	✅	Username TikTok, ví dụ: `@username` hoặc `username`
`limit`	int	❌	Số video tối đa (1–100). Mặc định: 50. TikTok tối đa 12
`min_revid`	string	❌	Cursor phân trang: bắt đầu sau video có ID này (dùng `max_revid` từ response trước)

Ví dụ¶

POST https://api.revidapi.com/paid/tiktok/username?username=@username&limit=12
POST https://api.revidapi.com/paid/tiktok/username?username=@username&limit=12&min_revid=7123456789

curl -X POST "https://api.revidapi.com/paid/tiktok/username?username=@username&limit=12" \
  -H "x-api-key: YOUR_API_KEY"

Phản hồi¶

Phản hồi thành công (200)¶

{
  "username": "@user",
  "items": [
    {
      "url": "https://www.tiktok.com/@user/video/7123456789",
      "title": "Video title",
      "duration": 15,
      "thumbnail": "https://...",
      "uploader": "user",
      "revid": "7123456789"
    }
  ],
  "count": 12,
  "limited_to": 12,
  "min_revid": "7123456789",
  "max_revid": "7123456700",
  "source": "revidapi.com",
  "cached": false
}

Các trường response¶

Trường	Kiểu	Mô tả
`username`	string	Username TikTok đã gửi
`items`	array	Danh sách video
`items[].url`	string	URL trang video (gọi `/download` với URL này để tải)
`items[].title`	string	Tiêu đề
`items[].duration`	int \| null	Thời lượng (giây)
`items[].thumbnail`	string \| null	URL thumbnail
`items[].uploader`	string \| null	Tên user
`items[].revid`	string \| null	ID video (dùng cho phân trang)
`count`	int	Số item trong `items`
`limited_to`	int	Giới hạn đã áp dụng
`min_revid`	string \| null	ID video đầu tiên trong batch
`max_revid`	string \| null	ID video cuối — gửi làm `min_revid` cho request tiếp theo
`source`	string	`revidapi.com`
`cached`	boolean	`true` nếu trả từ cache

Phân trang (TikTok)¶

TikTok tối đa 12 item/request. Request tiếp theo: min_revid=<max_revid từ response trước>.
Có thể cần tiktok_cookies.txt trên server để hoạt động ổn định.

Phản hồi lỗi¶

Status	Mô tả
502	Không lấy được video (cookies, rate limit, username sai). `detail` có hướng dẫn.

Ghi chú sử dụng¶

Workflow: Gọi endpoint /paid/tiktok/username lấy danh sách → lấy items[].url → gọi /download với từng URL để tải video.
Phân trang: Dùng max_revid từ response làm min_revid cho request tiếp theo.
Cache: Một số response có cached: true khi trả từ cache (TTL mặc định 1200s).