API Lấy danh sách video Douyin (theo `sec_user_id`)¶

Tổng quan¶

API này lấy danh sách video từ một kênh/user Douyin thông qua TikHub API, trả về aweme_id, mô tả, link video và link share.
Hỗ trợ phân trang bằng max_cursor

Giá cả¶

35 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/douyin/user/download
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). Lấy từ https://revidapi.com/

Query parameters¶

Tham số	Kiểu	Bắt buộc	Mô tả
`sec_user_id`	string	✅	`sec_user_id` của user Douyin (lấy từ URL trang cá nhân Douyin)
`max_cursor`	string	❌	Cursor phân trang; lần đầu gửi `"0"` hoặc bỏ trống, các lần tiếp theo dùng giá trị `max_cursor` trả về từ response trước. Mặc định `"0"`

Ví dụ¶

Lấy 1 trang đầu tiên (20 video)¶

curl -X POST "https://api.revidapi.com/paid/douyin/user/download?sec_user_id=MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE" \
  -H "x-api-key: YOUR_API_KEY"

Lấy trang tiếp theo (dùng `max_cursor`)¶

curl -X POST "https://api.revidapi.com/paid/douyin/user/download?sec_user_id=MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE&max_cursor=1734567890123" \
  -H "x-api-key: YOUR_API_KEY"

Phản hồi¶

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

{
  "sec_user_id": "MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE",
  "videos": [
    {
      "aweme_id": "7123456789012345678",
      "description": "Mô tả video",
      "video_url": "https://.../video.mp4",
      "share_url": "https://www.douyin.com/video/7123456789012345678"
    }
  ],
  "max_cursor": "1734567890123",
  "has_more": true,
  "total_fetched": 20
}

Các trường response¶

Trường	Kiểu	Mô tả
`sec_user_id`	string	`sec_user_id` đã gửi vào query
`videos`	array	Danh sách video
`videos[].aweme_id`	string	ID video Douyin
`videos[].description`	string	Mô tả video (từ trường `desc` của Douyin)
`videos[].video_url`	string \| null	URL file video (play/download) do TikHub trả về
`videos[].share_url`	string \| null	URL trang video trên `www.douyin.com`
`max_cursor`	string \| int	Cursor cho trang tiếp theo (gửi lại vào query `max_cursor` cho lần gọi tiếp theo)
`has_more`	bool	`true` nếu còn trang tiếp theo (khi `fetch_all=false`)
`total_fetched`	int	Tổng số video đã fetch trong response hiện tại

Phân trang¶

Lần đầu gọi: bỏ trống max_cursor hoặc gửi "0".
Các lần sau: dùng đúng giá trị max_cursor trả về từ response trước.

Phản hồi lỗi¶

Status	Mô tả
503	`Revidapi not configured` – server chưa cấu hình API key Revidapi
502	Lỗi từ Revidapi (code/message nằm trong trường `detail`) hoặc lỗi network / tham số không hợp lệ

Ghi chú sử dụng¶

Sec user id: bạn có thể lấy sec_user_id từ URL trang cá nhân Douyin trên web (thường dạng rất dài MS4wLjAB...).
Kết hợp với Download API: sau khi lấy danh sách, dùng videos[].share_url làm URL đầu vào cho endpoint /douyin/download trong Social Download API để tải video.
Giới hạn Revidapi: Revidapi có thể giới hạn số lượng video / tốc độ gọi; với kênh rất lớn nên bắt đầu với fetch_all=false và tự phân trang dần.
Ổn định: nếu thấy nhiều lỗi 502 từ Revidapi

API Lấy danh sách video Douyin (theo sec_user_id)¶