Social Download API

Pricing

5 credits per request

Fixed cost per download, regardless of video length or file size.

Overview

The Social Download API allows you to download media content from various social media platforms and online sources. This endpoint supports platforms like YouTube, TikTok, Instagram, Facebook, and many others using advanced download technologies.

Endpoint

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

Request

Headers

• x-api-key: Required. API key for authentication.

Query parameters

Parameter	Type	Required	Description
url	string (URI)	✅	URL of media content to download
format	string	❌	Format: best, worst, mp4, webm, or specific ID
quality	string	❌	Quality: 720p, 1080p, best, worst
extract_audio	boolean	❌	Extract audio only. Default: false
audio_format	string	❌	Audio format: mp3, m4a, wav. Default: mp3
id	string	❌	Custom identifier

Example Request

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"

Success Response (via Webhook or Direct)

{
  "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"
}

Response fields:

Field	Type	Description
url	string	Original URL sent
title	string	Video title
duration	int | null	Duration (seconds)
thumbnail	string | null	Thumbnail URL
uploader	string | null	Channel/uploader name
video_url	string	View/download URL (download-direct link, ~15 min validity)
download_direct	string | null	Direct file download URL
format	string	Format: mp4, webm, ...
filesize	int | null	File size (bytes)
source	string	revidapi.com
cached	boolean	true if from cache

Error Responses

Invalid Request (400)

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

Unsupported Platform (400)

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

Authentication Error (401)

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

Usage Notes

1. Fixed pricing: 5 credits per download request.
2. Video link: Use video_url or download_direct to view/download (~15 min validity). Call API again to get new link when expired.
3. Facebook/Instagram: Use specific video URL (e.g. .../videos/123456789/ or post link with video).
4. Audio extraction: Set extract_audio: true to get audio track only.

Common Issues

1. 502: Video private/age-restricted, invalid URL, platform blocking. Check detail in response.
2. Private content: Cannot be downloaded.
3. Link expired: download_direct expires after ~15 min — call API again for new link.

Best Practices

1. Use Webhooks: Always use webhooks for better reliability, especially for large files
2. Unique ID: Provide unique id value for tracking
3. Quality selection: Choose appropriate quality to balance file size and download speed
4. Error handling: Implement proper error handling for unsupported URLs or failed downloads
5. Legal compliance: Ensure you have rights to download and use the content

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
/youtube/download	Download YouTube media	POST