API Tải xuống từ mạng xã hội

Giá cả

5 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.

Tổng quan

API Tải xuống từ mạng xã hội cho phép bạn tải xuống nội dung phương tiện từ các nền tảng mạng xã hội và nguồn trực tuyến khác nhau. Endpoint này hỗ trợ các nền tảng như YouTube, TikTok, Instagram, Facebook và nhiều nền tảng khác bằng công nghệ tải xuống tiên tiến.

Endpoint

URL: POST https://api.revidapi.com/paid/{social}/download
Method: POST

Yêu cầu

Headers

x-api-key: Bắt buộc. API key để xác thực.

Query parameters

Tham số	Kiểu	Bắt buộc	Mô tả
`url`	string (URI)	✅	URL nội dung phương tiện cần tải xuống
`format`	string	❌	Định dạng: `best`, `worst`, `mp4`, `webm`, hoặc ID cụ thể
`quality`	string	❌	Chất lượng: `720p`, `1080p`, `best`, `worst`
`extract_audio`	boolean	❌	Chỉ trích xuất âm thanh. Mặc định: `false`
`audio_format`	string	❌	Định dạng âm thanh: `mp3`, `m4a`, `wav`. Mặc định: `mp3`
`id`	string	❌	Mã định danh tùy chỉnh

Ví dụ yêu cầu

POST https://api.revidapi.com/paid/tiktok/download?url=https://www.tiktok.com/@user/video/1234567890
POST https://api.revidapi.com/paid/douyin/download?url=https://www.douyin.com/video/7552522449193356595

curl -X POST "https://api.revidapi.com/paid/douyin/download?url=https://www.douyin.com/video/7552522449193356595" \
  -H "x-api-key: YOUR_API_KEY"

Phản hồi thành công (qua Webhook hoặc trực tiếp)

{
  "code": 200,
  "id": "download-request-123",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "response": {
    "url": "https://www.tiktok.com/@user/video/1234567890",
    "title": "Video Title",
    "duration": 180,
    "thumbnail": "https://example.com/thumb.jpg",
    "uploader": "Channel Name",
    "video_url": "https://edit.revidapi.com/download-direct?url=...&expires=...",
    "download_direct": "https://edit.revidapi.com/download-direct?url=...&expires=...",
    "format": "mp4",
    "filesize": 12345678,
    "source": "revidapi.com",
    "cached": false
  },
  "message": "success"
}

Các trường response:

Trường	Kiểu	Mô tả
`url`	string	URL gốc đã gửi
`title`	string	Tiêu đề video
`duration`	int \| null	Thời lượng (giây)
`thumbnail`	string \| null	URL ảnh thumbnail
`uploader`	string \| null	Tên kênh/người đăng
`video_url`	string	URL xem/tải (link download-direct, hiệu lực ~15 phút)
`download_direct`	string \| null	URL tải file trực tiếp
`format`	string	Định dạng: mp4, webm, ...
`filesize`	int \| null	Kích thước file (bytes)
`source`	string	`revidapi.com`
`cached`	boolean	`true` nếu trả từ cache

Phản hồi lỗi

Yêu cầu không hợp lệ (400)

{
  "code": 400,
  "id": "download-request-123",
  "message": "Invalid request: 'url' is a required property"
}

Nền tảng không được hỗ trợ (400)

{
  "code": 400,
  "id": "download-request-123",
  "message": "Unsupported platform or invalid URL"
}

Lỗi xác thực (401)

{
  "code": 401,
  "message": "Invalid API key"
}

Ghi chú sử dụng

Giá cố định: 5 credits mỗi yêu cầu tải xuống.
Link video: Dùng video_url hoặc download_direct để xem/tải (hiệu lực ~15 phút). Gọi lại API để lấy link mới khi hết hạn.
Facebook/Instagram: Dùng URL video cụ thể (ví dụ .../videos/123456789/ hoặc link post có video).
Trích xuất âm thanh: Đặt extract_audio: true để chỉ lấy track âm thanh.

Vấn đề thường gặp

502: Video private/giới hạn độ tuổi, URL sai, platform chặn. Kiểm tra detail trong response.
Nội dung riêng tư: Không thể tải xuống.
Link hết hạn: download_direct hết hạn sau ~15 phút — gọi lại API lấy link mới.

Thực hành tốt nhất

Sử dụng Webhooks: Luôn sử dụng webhooks để đảm bảo độ tin cậy tốt hơn, đặc biệt cho tệp lớn
ID duy nhất: Cung cấp giá trị id duy nhất để theo dõi
Lựa chọn chất lượng: Chọn chất lượng phù hợp để cân bằng kích thước tệp và tốc độ tải xuống
Xử lý lỗi: Triển khai xử lý lỗi phù hợp cho URL không được hỗ trợ hoặc tải xuống thất bại
Tuân thủ pháp lý: Đảm bảo bạn có quyền tải xuống và sử dụng nội dung

API Endpoints

Endpoint	Description	Method
`/douyin/download`	Download Douyin media	POST
`/meta/download`	Download Facebook/Instagram media	POST
`/threads/download`	Download Threads media	POST
`/tiktok/download`	Download TikTok media	POST
`/twitter/download`	Download Twitter media	POST