# Facebook Video Downloader Pro (`codenest/facebook-video-downloader-pro`) Actor Download Facebook videos and reels securely with Pro! 💾 Uses Key-Value Store for encrypted storage, persistent URLs, and reliable CDN access. Perfect for creators 🎬, marketers 📈, researchers 🔬 needing professional media archiving and batch processing solutions. 👌Facebook Video Downloader Pro. - **URL**: https://apify.com/codenest/facebook-video-downloader-pro.md - **Developed by:** [CodeNest](https://apify.com/codenest) (community) - **Categories:** Videos, Social media, Developer tools - **Stats:** 15 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $9.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Facebook Video Downloader Pro - Advanced Media Extraction Solution **🚀 Download Facebook videos and reels in highest quality with our professional Facebook Video Downloader Pro! This enterprise-grade actor provides secure storage, multiple resolution options, and comprehensive metadata extraction for all your Facebook content needs.** --- ### 📖 Overview The **Facebook Video Downloader Pro** is your ultimate solution for downloading Facebook videos, reels, and posts with maximum quality and reliability. This powerful actor leverages Apify's Key-Value Store for secure, persistent storage of your downloaded media assets. #### 🔑 Key-Value Store Benefits - **Secure Storage**: All downloads are safely stored in Apify's encrypted Key-Value Store - **Persistent URLs**: Download links remain accessible for extended periods - **Direct Access**: Get instant access to your media through reliable Apify CDN - **Batch Management**: Organize multiple downloads efficiently Perfect for content creators 🎬, marketers 📈, researchers 🔬, and developers 💻! --- ### ⚡ Core Capabilities #### 🎯 Media Options - **Multiple Resolutions**: SD (360p) to Full HD (1080p) support - **Separate Audio Tracks**: Extract audio-only M4A files - **Combined Videos**: Audio+video merged files available - **High-Quality Thumbnails**: Multiple preview images - **Bulk Processing**: Handle multiple URLs simultaneously #### 📊 Metadata Excellence - **Video Duration**: Precise timing in seconds - **View Counts**: Engagement metrics for posts - **Quality Variants**: Multiple format options - **Technical Specifications**: Complete format details #### 🛠 Advanced Features - **Key-Value Integration**: Automatic secure storage - **Quality Selection**: Auto-best or manual quality choice - **Proxy Support**: Bypass geographical restrictions - **Error Handling**: Robust failure recovery --- ### 🎮 Input Configuration Configure your **Facebook Video Downloader Pro** with this simple JSON structure: ```json { "key_value": true, "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" } ], "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357", "method": "GET" } ] } ```` #### 📋 Input Specifications | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `key_value` | Boolean | Yes | Enable secure Key-Value storage | | `post_urls` | Array | No | Facebook post/watch URLs | | `reel_urls` | Array | No | Facebook Reel URLs | | `url` | String | Yes | Valid Facebook video URL | | `method` | String | No | HTTP method (default: GET) | *** ### 📊 Output Structure The **Facebook Video Downloader Pro** provides comprehensive output: ```json [ { "url": "https://www.facebook.com/reel/1831270064408357/", "reel_id": "1831270064408357", "duration": 20.165, "reel_download_url": "https://api.apify.com/v2/key-value-stores/.../fb_reel_1b48989f-145e-4aab-b91b-764d41f07604.mp4", "audio_download_url": "https://api.apify.com/v2/key-value-stores/.../fb_audio_a14f3c2f-d124-4192-b0a2-1166aec50c2d.m4a", "thumbnail_url": "https://api.apify.com/v2/key-value-stores/.../fb_thumb_791d9844-2afd-48ca-88d0-46aa6cba9718.jpg", "format_id": "hd", "ext": "mp4", "video_variants": [...], "video_with_audio_variants": [...], "audio_variants": [...], "thumbnails": [...], "use_kv_store": true } ] ``` #### 📖 Output Field Documentation **🔍 Metadata Section** | Field | Description | |-------|-------------| | `reel_id` | Unique Facebook video identifier | | `duration` | Video length in seconds (decimal precision) | | `view_count` | Number of views (posts only) | | `format_id` | Quality identifier (hd, sd, etc.) | | `ext` | File format extension | **🎬 Media Assets (Key-Value Store)** | Field | Description | |-------|-------------| | `reel_download_url` | Secure video download from KV store | | `audio_download_url` | Separate audio track from KV store | | `thumbnail_url` | High-quality preview from KV store | | `use_kv_store` | Confirmation of storage method | **📺 Quality Variants** | Field | Description | |-------|-------------| | `video_variants` | Separate video streams (no audio) | | `video_with_audio_variants` | Combined audio+video streams | | `audio_variants` | Audio-only streams | | `height` | Vertical resolution in pixels | | `width` | Horizontal resolution in pixels | *** ### 🎚 Quality Tiers Available The **Facebook Video Downloader Pro** automatically detects all available qualities: #### 🥇 High Definition - **1080p** (1920x1080) - Full HD excellence - **720p** (1280x720) - HD quality - Perfect for professional editing and archiving #### 🥈 Standard Definition - **540p** (960x540) - Balanced quality - **360p** (640x360) - Mobile optimized - Ideal for quick sharing and streaming #### 🎵 Audio Options - **Separate M4A tracks** for audio processing - **Merged MP4 files** for immediate use - Multiple bitrate options available *** ### 💡 Technical Features #### 🔒 Secure Storage Architecture - **Encrypted KV Store**: Military-grade security for your downloads - **CDN Acceleration**: Global content delivery network - **Persistent Access**: Long-lasting download URLs - **Automatic Cleanup**: Smart storage management #### 🎞 Advanced Format Support - **Multiple Codecs**: H.264, AAC audio support - **Container Formats**: MP4 video, M4A audio - **Quality Detection**: Automatic best-quality selection - **Stream Separation**: Isolated audio/video tracks #### 📈 Metadata Extraction - **Precision Timing**: Millisecond-accurate duration - **Engagement Metrics**: View counts and performance data - **Technical Specs**: Complete format documentation - **Quality Analysis**: Multiple variant comparison *** ### 🎯 Use Cases for Facebook Video Downloader Pro #### 👥 Content Creators & Agencies - Archive client content securely - Repurpose videos for multiple platforms - Maintain quality across distributions #### 🔬 Researchers & Analysts - Study video performance metrics - Analyze content trends - Collect data for academic research #### 💻 App Developers - Integrate Facebook video functionality - Build video processing applications - Create content management systems #### 📱 Social Media Managers - Backup important campaign videos - Create content libraries - Repurpose high-performing content *** ### 🌟 Why Choose Our Facebook Video Downloader Pro? #### 🔐 Security & Reliability - **Encrypted Storage**: All downloads protected in KV store - **Reliable Access**: 99.9% uptime guarantee - **Data Integrity**: Checksum verification for all files #### ⚡ Performance Excellence - **Fast Processing**: Parallel download capabilities - **Quality Preservation**: Original quality maintenance - **Batch Operations**: Multiple video processing #### 🛠 Developer Friendly - **RESTful API**: Easy integration - **Comprehensive Documentation**: Quick implementation - **Webhook Support**: Real-time notifications *** ### ⚠️ Limitations - Requires public Facebook videos or proper access permissions - Subject to Facebook's rate limiting and terms of service - Video availability depends on original content permissions *** ### 🔗🛠 Related Actors (Complete Social Media Suite) #### 🌐 Facebook Ecosystem - [Facebook Video Transcript Scraper](https://apify.com/codenest/facebook-video-transcript-scraper) - [Facebook Reels Downloader](https://apify.com/codenest/facebook-reels-downloader) - [Facebook Reels Audio Downloader](https://apify.com/codenest/facebook-reels-audio-downloader) - [Facebook Thumbnail Downloader(Reels & Video)](https://apify.com/codenest/facebook-thumbnail-downloader-reels-video) - [Facebook Reels & Video Downloader](https://apify.com/codenest/facebook-reels-video-downloader) - [Facebook Reels Scraper & Reels Downloader](https://apify.com/codenest/facebook-reels-scraper-reels-downloader) *** ### 📧 Need Customization? Looking for **enhanced features, higher resolutions, or specialized workflows** with our **Facebook Video Downloader Pro**? ✉️ Email **** for tailored solutions! *** *The **Facebook Video Downloader Pro** is your professional choice for reliable, high-quality Facebook video downloads with enterprise-grade security and storage solutions.* # Actor input Schema ## `reel_urls` (type: `array`): List of public Facebook Reels URLs. Also supports fb.watch and will resolve share/v links. ## `post_urls` (type: `array`): List of public Facebook video post URLs. ## `key_value` (type: `boolean`): Enable or disable storing files in the key-value store. When enabled, videos, audio, and thumbnails are downloaded and stored in Apify's KV store for reliable access. ## Actor input object example ```json { "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357" } ], "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" }, { "url": "https://web.facebook.com/watch/?v=1374855850246642" } ], "key_value": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357" } ], "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" }, { "url": "https://web.facebook.com/watch/?v=1374855850246642" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("codenest/facebook-video-downloader-pro").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "reel_urls": [{ "url": "https://web.facebook.com/reel/1831270064408357" }], "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" }, { "url": "https://web.facebook.com/watch/?v=1374855850246642" }, ], } # Run the Actor and wait for it to finish run = client.actor("codenest/facebook-video-downloader-pro").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357" } ], "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" }, { "url": "https://web.facebook.com/watch/?v=1374855850246642" } ] }' | apify call codenest/facebook-video-downloader-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=codenest/facebook-video-downloader-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Video Downloader Pro", "description": "Download Facebook videos and reels securely with Pro! 💾 Uses Key-Value Store for encrypted storage, persistent URLs, and reliable CDN access. Perfect for creators 🎬, marketers 📈, researchers 🔬 needing professional media archiving and batch processing solutions. 👌Facebook Video Downloader Pro.", "version": "0.0", "x-build-id": "OB6g43B4NyRiebAw2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codenest~facebook-video-downloader-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codenest-facebook-video-downloader-pro", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/codenest~facebook-video-downloader-pro/runs": { "post": { "operationId": "runs-sync-codenest-facebook-video-downloader-pro", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/codenest~facebook-video-downloader-pro/run-sync": { "post": { "operationId": "run-sync-codenest-facebook-video-downloader-pro", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "reel_urls": { "title": "Facebook Reels URLs", "type": "array", "description": "List of public Facebook Reels URLs. Also supports fb.watch and will resolve share/v links.", "items": { "type": "object", "properties": { "url": { "title": "Reel URL", "description": "Examples: https://www.facebook.com/reel/{id}/, https://www.facebook.com/watch/?v={id}, https://fb.watch/{short}, https://www.facebook.com/share/v/{token}/", "type": "string", "pattern": "^https://(((www|web|m)\\.)?facebook\\.com/|fb\\.watch/).+" } }, "required": [ "url" ] } }, "post_urls": { "title": "Facebook Video Post URLs", "type": "array", "description": "List of public Facebook video post URLs.", "items": { "type": "object", "properties": { "url": { "title": "Post URL", "description": "Public Facebook video post URL (supports facebook.com, web.facebook.com, www.facebook.com and fb.watch short links; share/v viewer links are not supported).", "type": "string", "pattern": "^https://((((www|web)\\.)?facebook\\.com/)|fb\\.watch/)" } }, "required": [ "url" ] } }, "key_value": { "title": "Store files in the key-value store?", "type": "boolean", "description": "Enable or disable storing files in the key-value store. When enabled, videos, audio, and thumbnails are downloaded and stored in Apify's KV store for reliable access.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```