# Facebook Video Downloader (`solid-scraper/facebook-video-downloader`) Actor 📹✨ Download Facebook videos fast and free! With our Facebook Video Downloader, save reels, clips, and stories in seconds. No hassle, just high-quality downloads on any device. 🚀💾 Try it now! - **URL**: https://apify.com/solid-scraper/facebook-video-downloader.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Videos, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Actor 🎥 **Facebook Video Downloader Actor** lets you download Facebook video links by processing one or more Facebook video URLs and extracting the available playback options, including a best-fit result for the resolution you request. Whether you’re a marketer, content repurposer, researcher, or creator, this **facebook video downloader actor** helps you streamline **facebook video downloader app** and **facebook video downloader online** workflows—saving you hours of manual work. --- ### Why choose Facebook Video Downloader Actor? | Feature | Benefit | | --- | --- | | ✅ **Resolutions you can request** | You choose a target quality (like 1080p or 720p) and get the closest available match. | | ✅ **Reel vs long video handling** | The actor classifies videos (reel or long video) and selects formats accordingly. | | ✅ **Built-in resilience** | Includes fallbacks for choosing formats when the requested quality isn’t available. | | ✅ **Structured dataset output** | Results are stored in a dataset with consistent fields for easy downstream use. | | ✅ **Scales across multiple URLs** | Submit an array of `video_urls` and process them in one run. | | ✅ **Automation-friendly JSON** | Export-friendly output that integrates well into analysis pipelines and tools. | --- ### Key features - 🎯 **Resolution-aware downloads:** Requests a target resolution and selects the closest available quality. - 🧩 **Video type detection:** Labels videos as `reel` (duration < 60 sec) or `long video` (duration ≥ 60 sec). - 📊 **Complete metadata object:** Captures available general video metadata in `general_metadata` (only keys that have values). - 🔍 **Clear match note:** Adds a `note` explaining whether your requested resolution was found or what was selected instead. - 💾 **Download links bundle:** Produces `download_links` for merged video / video-only / audio when available. - 🌐 **Bulk URL support:** Processes all items from your `video_urls` list in a single actor run. - 🛡️ **Format fallback logic:** If the requested quality isn’t found, it automatically selects the highest available. - 🚀 **Dataset-first workflow:** Each processed URL is pushed to the Apify dataset for quick viewing and export. --- ### Input Provide input via an `input.json` file. Example structure: ```json { "video_urls": [ { "url": "https://www.facebook.com/share/v/18zL4zNBNJ/" }, { "url": "https://www.facebook.com/share/r/168H2dZLPu/" } ], "requested_resolution": "1080p" } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `video_urls` | Yes | A list of Facebook video URLs to process. You can pass them as objects containing `url`. | | `requested_resolution` | No | The resolution you want (e.g., `1080p`, `720p`, `480p`). If you don’t provide it, the actor defaults to `1080p`. | Supported `requested_resolution` values: `1080p`, `720p`, `640p`, `540p`, `480p`, `360p`, `270p`, `240p`. *** ### Output The actor saves each video result in JSON format. ```json [ { "video_url": "https://www.facebook.com/share/v/18zL4zNBNJ/", "requested_resolution": "1080p", "video_type": "reel", "general_metadata": { "title": "Example title", "author": "Example uploader", "thumbnail": "https://example.com/thumbnail.jpg", "duration": 45, "channel_name": "Example uploader", "video_language": "en", "video_age_restriction": "18+" }, "found_resolution": "1080p", "note": "Congrats! Your requested resolution was found.", "download_links": { "merged_video": "https://example.com/merged.mp4", "video": "https://example.com/video_only.mp4", "audio": "https://example.com/audio.mp4" } } ] ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `video_url` | string | The Facebook video URL that was processed. | | `requested_resolution` | string | The resolution requested, or `"Highest Available"` when not provided. | | `video_type` | string | Video classification: `reel` (duration < 60 sec) or `long video` (duration ≥ 60 sec). | | `general_metadata` | object | Collected metadata about the video (only includes keys that have a value). | | `found_resolution` | string | The detected resolution formatted as height plus `p` (e.g., `720p`) or `"Unknown"`. | | `note` | string | Explains whether the requested resolution was found, or what was selected instead. | | `download_links` | object | Links to selected formats, including merged video/video-only and audio when available. | | `error` | string | Present when a run item fails; contains the error message (for that `video_url`). | > Tip: The dataset structure is designed to make it easy to build a **facebook reels downloader** workflow (for reels) and a **facebook live video downloader** style workflow (for longer videos) without manual cleanup. *** ### How to use Facebook Video Downloader Actor (via Apify Console) 1. **Open Apify Console**\ Log in at https://console.apify.com and go to the **Actors** section. 2. **Find the actor**\ Search for **Facebook Video Downloader Actor** and open its actor page. 3. **Go to the INPUT tab**\ Enter your inputs using the built-in form fields for `video_urls` and `requested_resolution`. 4. **Add your Facebook video URLs**\ Paste one or more Facebook video URLs into `video_urls` (the actor accepts a list). 5. **Choose a resolution (optional)**\ Set `requested_resolution` to one of: `1080p`, `720p`, `640p`, `540p`, `480p`, `360p`, `270p`, `240p`.\ If you leave it empty, it uses the default `1080p`. 6. **Run the actor**\ Click **Run**. During execution you’ll see logs indicating which URL is being processed and whether it succeeded or failed. 7. **Review results in the OUTPUT / Dataset**\ After the run completes, open the dataset to browse the table view and export as JSON/CSV. 8. **Use the download links**\ For each row, check `download_links` and `found_resolution`. You’ll also get a `note` telling you whether the requested resolution was available. No coding required—get results in minutes with this **facebook video downloader extension**-style workflow, but powered as an automated actor. *** ### Advanced features & SEO optimization - 🎛️ **Resolution match + fallback:** If your requested resolution can’t be matched, the actor automatically selects the highest available option and records this in the `note`. - 🧠 **Reels vs long videos:** It determines `video_type` based on duration so that your **facebook reels downloader** results are handled appropriately. - 🔄 **Format selection across merged/video-only/audio:** The output includes a `download_links` object that can provide `merged_video`, `video`, and `audio` (or `"Not available"` for audio when applicable). - 📝 **Structured, export-ready metadata:** The `general_metadata` field keeps your downstream **facebook story video downloader** and analysis pipelines tidy. - 🛡️ **Proxy support for reliability:** Includes built-in proxy support to improve reliability when processing multiple URLs at scale. *** ### Best use cases - 📈 **Repurpose reels for campaigns:** Download the best matching quality for **facebook reels downloader** workflows and keep your creative library consistent. - 🎥 **Content researchers & analysts:** Compare `found_resolution`, `video_type`, and metadata across a batch of URLs for reporting. - 💼 **Lead-gen and outreach teams (B2B):** Use exported results to organize assets for **facebook video downloader app** content—then pair with your outreach processes. - 🛠️ **Marketing ops automation:** Run scheduled jobs for a list of URLs to quickly generate a dataset-ready archive of video download options. - 🧪 **Product and UX testing:** Validate how video formats and resolutions vary by source URL using `found_resolution` and `download_links`. - 💻 **Developer pipelines:** Feed the dataset output into your own tooling for transformations, asset management, or further processing. - 📺 **Live/long-form archiving:** For `long video`, capture the available resolution and links in one pass using the same **facebook video downloader actor** workflow. *** ### Technical specifications - **Supported Input Formats** - ✅ `video_urls` as an array of items (each item can be an object with `url`, or a direct string URL) - ✅ `requested_resolution` as a string enum: `1080p`, `720p`, `640p`, `540p`, `480p`, `360p`, `270p`, `240p` - **Proxy Support** - ✅ Built-in proxy support is used to improve reliability for scraping. - **Retry Mechanism** - ✅ Designed with resilience and fallbacks when the requested resolution isn’t available. - **Dataset Structure** - ✅ Dataset stores one JSON object per processed video (or one per entry in a carousel), with fields: `video_url`, `requested_resolution`, `video_type`, `general_metadata`, `found_resolution`, `note`, `download_links` (and `error` on failures). - **Rate Limits & Performance** - ✅ Performance depends on URL responsiveness and the available formats for each video. - **Limitations** - ❌ If a URL is invalid or processing fails, the actor pushes an object containing `video_url` and `error`. - ⚠️ The actor may select **the highest available resolution** when the exact requested resolution cannot be found. *** ### FAQ #### Can I download Facebook videos in 1080p using Facebook Video Downloader Actor? ✅ Yes—set `requested_resolution` to `1080p`. If that exact quality isn’t available, the actor records a `note` and selects the closest match or the highest available resolution. #### How does it decide whether a video is a reel or a long video? ✅ It determines `video_type` based on duration. Videos with duration under 60 seconds are labeled `reel`; otherwise they’re labeled `long video`. #### What does the actor return in the dataset? ✅ Each processed result is pushed to the dataset as JSON including `video_url`, `requested_resolution`, `video_type`, `general_metadata`, `found_resolution`, `note`, and `download_links`. If something fails for a URL, it returns `video_url` plus `error`. #### Does it include audio download links? ✅ Audio links can be included inside `download_links` under `audio` when available; otherwise the value is `"Not available"`. #### Can I submit multiple Facebook video URLs in one run? ✅ Yes. Provide an array in `video_urls`, and the actor processes each item and stores the results in the dataset. #### Is there an API or code requirement to use this actor? ❌ No. You can run it through Apify Console by providing `video_urls` and an optional `requested_resolution`. If you want to integrate programmatically, you can still export the dataset and use it in your own workflows. #### What if the requested resolution is not found? ✅ The actor sets `found_resolution` and uses `note` to explain what happened—either confirming the match or stating that it selected the highest available resolution instead. *** ### Support & feature requests Have questions about **Facebook Video Downloader Actor**, or want to suggest improvements for a better **facebook video downloader online** experience? 💬 - 💡 **Feature Requests:** Share enhancements like additional output fields, more resolution options, or improved dataset formatting for **download facebook videos without watermark** workflows. - 📧 **Contact:** Email . Your feedback directly shapes what we build next for Facebook Video Downloader Actor. *** ### Closing CTA / Final thoughts *If you’re looking for a practical, resolution-aware **Facebook Video Downloader Actor** to streamline downloads at scale, this is built for you.* SEO-optimized outputs and dataset-ready results help you move faster—without extra manual steps. *** ### Disclaimer **This tool accesses only publicly accessible sources.** It does not access private profiles, authenticated data, or password-protected pages. It’s your responsibility to comply with applicable laws (including GDPR/CCPA), platform terms, and spam regulations when downloading or reusing video content. For data removal requests, contact . Please use this actor responsibly, ethically, and only for legitimate purposes. # Actor input Schema ## `video_urls` (type: `array`): List of Facebook video URLs to process. ## `requested_resolution` (type: `string`): Select your desired resolution. ## Actor input object example ```json { "video_urls": [ { "url": "https://www.facebook.com/share/v/18zL4zNBNJ/" }, { "url": "https://www.facebook.com/share/r/168H2dZLPu/" } ], "requested_resolution": "1080p" } ``` # 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 = { "video_urls": [ { "url": "https://www.facebook.com/share/v/18zL4zNBNJ/" }, { "url": "https://www.facebook.com/share/r/168H2dZLPu/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/facebook-video-downloader").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 = { "video_urls": [ { "url": "https://www.facebook.com/share/v/18zL4zNBNJ/" }, { "url": "https://www.facebook.com/share/r/168H2dZLPu/" }, ] } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/facebook-video-downloader").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 '{ "video_urls": [ { "url": "https://www.facebook.com/share/v/18zL4zNBNJ/" }, { "url": "https://www.facebook.com/share/r/168H2dZLPu/" } ] }' | apify call solid-scraper/facebook-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/facebook-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Video Downloader", "description": "📹✨ Download Facebook videos fast and free! With our Facebook Video Downloader, save reels, clips, and stories in seconds. No hassle, just high-quality downloads on any device. 🚀💾 Try it now!", "version": "1.0", "x-build-id": "YCN98nbpAl0dSVe5u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~facebook-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-facebook-video-downloader", "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/solid-scraper~facebook-video-downloader/runs": { "post": { "operationId": "runs-sync-solid-scraper-facebook-video-downloader", "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/solid-scraper~facebook-video-downloader/run-sync": { "post": { "operationId": "run-sync-solid-scraper-facebook-video-downloader", "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", "required": [ "video_urls" ], "properties": { "video_urls": { "title": "Facebook Video URLs", "type": "array", "description": "List of Facebook video URLs to process.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "requested_resolution": { "title": "Requested Resolution", "enum": [ "1080p", "720p", "640p", "540p", "480p", "360p", "270p", "240p" ], "type": "string", "description": "Select your desired resolution.", "default": "1080p" } } }, "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 } } } } } } } } } } ```