Meta Media Downloader | Download Facebook & Instagram Videos, Reels & Images

Easily download Facebook and Instagram videos, images, reels, and stories with this powerful tool. Perfect for content creators, marketers, and social media managers, it ensures fast, high-quality media extraction from Meta platforms. Save and repurpose content effortlessly in just a few clicks!

🚀 Key Features

• Facebook Support: Download videos and images from Facebook posts, reels, and stories
• Instagram Support: Extract content from Instagram posts, reels, and stories
• Highest Quality Extraction: Always downloads the highest quality version available
• Video-Only Mode: Option to download only videos and skip images
• Multi-Image Support: Extracts all images from posts with multiple photos
• Flexible Configuration: Customize proxy settings, timeouts, and retry mechanisms
• Secure Storage: All media files are stored securely in Apify's key-value store
• Detailed Metadata: Preserves quality, type, and source information for each download

📋 Input Parameters

The Actor accepts the following input parameters:

Required Parameters

• startUrls (Array) - List of Facebook or Instagram URLs to process. Examples:

  1[
  2  { "url": "https://www.facebook.com/reel/1218203106348274" },
  3  { "url": "https://www.instagram.com/reel/CS-D8V2niR-/" }
  4]
  

• proxyConfiguration (Object) - Configure proxy settings to avoid rate limiting and improve reliability

  • Recommended: Enable Apify Proxy for optimal performance
  • Supports custom proxy configuration

Optional Parameters

• videoOnly (Boolean) - When true, only downloads videos and skips images. Default: true
• downloadTimeoutSecs (Integer) - Timeout in seconds for media downloads. Increase this if downloading large files. Default: 500
• maxRequestRetries (Integer) - Number of retry attempts for failed requests. Default: 15

📊 Output

For each successfully processed URL, the Actor saves:

1{
2  "sourceUrl": "https://www.facebook.com/reel/1218203106348274",
3  "quality": "HD",
4  "type": "mp4",
5  "timestamp": "2025-03-17T05:38:27.422Z",
6  "filename": "8556c95c-5caf-40a3-8d34-82f37b7562c9.mp4",
7  "fileUrl": "https://api.apify.com/v2/key-value-stores/[store-id]/records/8556c95c-5caf-40a3-8d34-82f37b7562c9",
8  "isImage": false
9}

• sourceUrl: Original Facebook or Instagram URL
• quality: Quality level of the downloaded media (e.g., "HD", "SD", "Original")
• type: File format of the media (e.g., "mp4" for video, "image" for photos)
• timestamp: ISO timestamp of when the media was downloaded
• filename: Unique identifier for the file with appropriate extension
• fileUrl: Direct URL to download the media file from Apify's storage
• isImage: Boolean indicating whether the media is an image or video

🔧 Usage

1. Create a new task for this Actor on the Apify platform
2. Configure the input parameters:
   • Add Facebook and Instagram URLs to the startUrls array
   • Set videoOnly to true if you only want videos
   • Adjust performance settings if needed
   • Set up proxy configuration (required)
3. Run the Actor and wait for the results
4. Access your downloaded media files through the provided URLs in the dataset

💡 Best Practices

1. Proxy Usage: Always configure proxy settings as it's required for reliable operation
2. Video-Only Mode: Use videoOnly: true when you specifically need video content
3. Timeout Settings: Adjust downloadTimeoutSecs based on expected file sizes
4. Retries: Keep maxRequestRetries high enough to handle temporary failures
5. URL Format: Ensure URLs are direct links to posts, reels, or stories

📚 How It Works

1. The Actor processes each URL in the startUrls array
2. It determines whether the URL is from Facebook or Instagram
3. For Facebook:
   • Extracts the highest quality video if available
   • If no video is found and videoOnly is false, extracts all images
4. For Instagram:
   • Downloads the media content (video or image)
5. All media files are stored in Apify's key-value store
6. Detailed metadata is saved to the dataset

🔗 Resources

• Apify SDK Documentation
• Crawlee Documentation
• Apify Platform Documentation
• Apify Actors Documentation
• Apify Proxy Documentation