All Social Media Video Downloader

Extract direct video links from major social media platforms via a simple API. This actor handles downloading and can merge audio/video streams for supported sites.

Key Features

• Multi-Platform Support: Works with YouTube, Facebook, Instagram, Twitter, TikTok (without watermark), Dailymotion, LinkedIn, Vimeo, and others.
• Direct Integration: Provides straightforward API endpoints.
• Audio/Video Merging: Can merge separate audio and video streams for Facebook, Instagram, and YouTube content.
• Proxy Support: Requires residential proxies (like Apify Proxy) for reliable access to social platforms.

How to Use

Send a POST request to the sync endpoint with a JSON payload containing the video URL.

Endpoint:

POST https://api.apify.com/v2/acts/wilcode~all-social-media-video-downloader/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>

Basic Request

All requests require a url. Using proxySettings with a residential proxy group is recommended for consistent results, especially for TikTok.

{
  "url": "https://www.tiktok.com/@user/video/123456789",
  "proxySettings": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Platform-Specific Options

For Facebook & Instagram: Use mergeAV: true to download and merge audio and video.
For YouTube: Use mergeYoutube to specify a quality and merge streams.

// Facebook/Instagram example
{
  "url": "https://www.facebook.com/reel/12345",
  "mergeAV": true,
  "proxySettings": { ... }
}

// YouTube example
{
  "url": "https://www.youtube.com/watch?v=abc123",
  "mergeYoutube": { "quality": 720 },
  "proxySettings": { ... }
}

cURL Example:

curl -X POST "https://api.apify.com/v2/acts/wilcode~all-social-media-video-downloader/run-sync-get-dataset-items?token=<token>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=abc123", "proxySettings": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}}'

Input / Output

Input Parameters

• url (string, required): The full URL of the social media video.
• proxySettings (object, optional): Proxy configuration. Use residential proxies for best results.
• mergeAV (boolean, optional): Set to true to merge audio and video for Facebook/Instagram links.
• mergeYoutube (object, optional): For YouTube videos. Specify {"quality": 720} to merge streams at a given resolution.

Output

The actor returns metadata and download links in the dataset. Download times vary (2-360 seconds) based on video size and proxy.

For YouTube, Instagram, Facebook (with merge options):
A download field contains the link to the merged video file, saved to your Apify storage.

For other platforms:
A formats array lists available resolutions and their direct download links.

Example Response:

{
  "title": "Video Title",
  "uploader": "Channel Name",
  "duration": 100,
  "thumbnail": "https://...",
  "formats": [
    { "resolution": "720x1080", "url": "https://direct-download.link" },
    { "resolution": "1080x1920", "url": "https://direct-download.link" }
  ],
  "download": [ { "resolution": 720, "url": "https://api.apify.com/v2/key-value-stores/..." } ]
}

For a detailed user guide, visit: https://wilcode-net.gitbook.io/all-social-media-video-downloader-apify