# Facebook Video Downloader (`scrapeflux/facebook-video-downloader`) Actor Facebook Video Downloader lets you save publicly available Facebook videos quickly and efficiently. Download videos for content research, social media monitoring, archiving, marketing analysis, and offline viewing with a fast, reliable, and easy-to-use solution. - **URL**: https://apify.com/scrapeflux/facebook-video-downloader.md - **Developed by:** [ScrapeFlux](https://apify.com/scrapeflux) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.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.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 Actor ⚡ If you want to **download Facebook videos at a specific quality** but don’t want to waste time clicking around for each link, Facebook video downloader tasks quickly become a mess. The **Facebook Video Downloader Actor** takes the URLs you provide and returns ready-to-use download links in your Apify dataset—perfect for a Facebook video downloader actor workflow. It also supports reel-style vs long-form video handling, so you’re not guessing. This is built for marketers, analysts, and researchers who need fast, repeatable video download results at scale. Run one job and process multiple Facebook video URLs with a single click—results start showing within seconds. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "video_url": "https://www.facebook.com/share/v/18zL4zNBNJ/", "requested_resolution": "1080p", "video_type": "reel", "general_metadata": { "title": "City Night Walk", "author": "John Doe", "thumbnail": "https://example.com/thumb.jpg", "duration": 42, "channel_name": "John Doe", "video_language": "en", "video_age_restriction": 13 }, "found_resolution": "1080p", "note": "Congrats! Your requested resolution was found.", "download_links": { "merged_video": "https://example.com/merged.mp4", "video": "https://example.com/video.mp4", "audio": "https://example.com/audio.m4a" }, "status": "success" } ```` | Field | Type | What It Tells You | |---|---|---| | `video_url` | string | The input Facebook video URL this record was generated from. | | `requested_resolution` | string | The resolution you asked for (or `"Highest Available"` when not provided). | | `video_type` | string | Whether the content is treated as a `"reel"` or a `"long video"` based on duration. | | `general_metadata` | object | Useful context like title, author, thumbnail, duration, and optional language/age/location fields (only included when present). | | `found_resolution` | string | The actual resolution selected for the downloadable video. | | `note` | string | A friendly message telling you whether your requested resolution was found or the actor fell back. | | `download_links` | object | The selected media URLs you can use for your download workflow. | | `download_links.merged_video` | string | A combined (merged) video link when available. | | `download_links.video` | string | Video-only link when selected (may be included when it’s higher than merged). | | `download_links.audio` | string | Audio link when available, or `"Not available"`. | | `status` | string | Indicates success/failure status for the record (alongside any error info). | | `error_message` | string | null | Present when an error occurs; otherwise null/not included depending on the record. | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "video_urls": [ { "url": "https://www.facebook.com/share/v/18zL4zNBNJ/" }, { "url": "https://www.facebook.com/share/r/168H2dZLPu/" } ], "requested_resolution": "720p" } ``` | Parameter | Required | What It Does | |---|---|---| | `video_urls` | ✅ | A list of Facebook video URLs to process. Each entry can be provided as an object with a `url`. | | `requested_resolution` | ⬜ | The resolution you want (e.g. `1080p`, `720p`). If you don’t set it, the actor selects the highest available resolution. | *** ### What It Does This Facebook video downloader actor fetches video information from each Facebook video URL you provide, then returns selected media download links and metadata to your dataset. #### Processes multiple Facebook video URLs in one run You can pass one or many `video_urls`, and the actor will generate a dataset record for each video (including handling cases where a URL contains multiple entries). This makes it a solid Facebook reel downloader actor option when you’re working with batches. #### Resolution-aware downloads (with clear fallback notes) When you set `requested_resolution`, the actor attempts to select media at your desired quality and records what it actually picked in `found_resolution`. If your requested resolution isn’t available, you’ll see an explanatory message in `note`, and it will fall back to the best option. #### Structured output that’s easy to reuse Each dataset record includes `general_metadata`, the selected `found_resolution`, and a `download_links` object containing the relevant media URLs. This structured output is practical for downstream workflows like reporting, cataloging, or integrating into your video download helper pipeline. #### Handles reel vs long video logic automatically The actor determines `video_type` based on duration: videos under 60 seconds are labeled as `"reel"`, and longer content is labeled as `"long video"`. That `video_type` is also used when applying resolution selection behavior, so your Facebook reel downloader workflows behave consistently. #### Error handling per URL If a specific URL fails, the actor still pushes a result record containing `video_url` and an error message to your dataset. This way you can review failures without losing successful results from the rest of your run. *** ### Why Facebook Video Downloader Actor? There are plenty of ways to pull video download links from Facebook—here’s why **Facebook Video Downloader Actor** stands out. #### Batch-friendly for real workflows Instead of handling one link at a time, this Facebook video downloader actor is designed to process a list of URLs and output results immediately into the dataset. That’s especially useful for researchers and teams building a repeatable “download Facebook videos without watermark” style library workflow (where available content matches your needs). #### Clear, user-facing resolution outcomes You don’t just get links—you also get `requested_resolution`, `found_resolution`, and a `note` explaining what happened. That transparency helps you avoid silent quality mismatches common with basic download tools. #### Output is ready for analysis and automation Because results include `general_metadata` and consistent `download_links`, the output is easy to sort, filter, and plug into pipelines. If you’re using a Facebook video download helper approach with exports or an automation layer, this structured format saves time. *** ### Real-World Use Cases Here's how different teams put Facebook Video Downloader Actor to work: **Video Ops for Agencies**\ An agency needs to audit a set of creator videos for campaign reuse and quality before contacting creators. They feed a list of video URLs, request a specific resolution, and quickly review `found_resolution` and `download_links` in the dataset to decide what’s usable. **Social Media Researchers**\ A researcher is collecting a sample set of public Facebook reel content across multiple posts for a study. They run the Facebook reel downloader actor workflow, using `video_type` and `general_metadata` to organize items and export results for analysis. **Marketing Analysts Building Content Libraries**\ An analyst wants to build a consistent library of long-form and short-form creatives and measure which qualities are most commonly available. By comparing `requested_resolution` vs `found_resolution` across runs, they get an evidence-based view instead of guessing. **Automation Specialists (Developers & Integrators)**\ A data engineer wants reliable, structured records for downstream processing. They trigger the actor via API, then map each `download_links` field into their internal pipeline for storage, indexing, and QA—without manual copy/paste. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Open the actor on Apify**\ Go to the actor page on Apify: https://console.apify.com 2. **Enter your inputs**\ Add your list in `video_urls` and (optionally) set `requested_resolution` to one of: `1080p`, `720p`, `640p`, `540p`, `480p`, `360p`, `270p`, `240p`. 3. **Configure proxy settings (high level)**\ Keep proxy support enabled for best reliability—this actor is designed for reliable scraping using proxy support. 4. **Start the run**\ Click **Run** and watch the live log to confirm each URL is being processed. 5. **Open the Dataset tab**\ As each URL completes, you’ll see structured records with `general_metadata`, `found_resolution`, and `download_links`. 6. **Export in your preferred format**\ Download as JSON, CSV, or Excel directly from the dataset tab. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Facebook Video Downloader Actor fits directly into your existing workflow. Export your dataset from the Apify dashboard in **JSON**, **CSV**, or **Excel**, depending on what your team uses for analysis or reporting. If you’re working in spreadsheets, you can also push the dataset into tools connected through Apify integrations and no-code automation. For deeper automation, you can access results programmatically via the **Apify API**, or connect follow-up steps using **webhooks** so your pipeline can start downloading and organizing media automatically after each run completes. If your team relies on Zapier or Make, you can wire the actor into your automation flows as well. *** ### Pricing Facebook Video Downloader Actor runs on Apify, which includes a **free tier** — no credit card needed to start. Free test runs can be enough to validate resolution choices like `1080p` vs `720p`, and confirm output format for your workflow. For ongoing usage, you’ll typically pay **pay-as-you-go** based on Apify compute usage (Actor compute units), with subscription plans available for heavier workloads. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Rate-limit sensitivity | Built for reliable batch processing with proxy support. | | URL-level failures | Errors are pushed as records including `video_url` and the error details. | | Resolution availability gaps | Falls back gracefully when the requested resolution can’t be matched, with an explanatory `note`. | | Partial successes | Each input URL produces its own result record, so one failure won’t break the entire dataset. | Limitations: this actor depends on what’s publicly available from the provided video URLs and the available media formats. It may not find your requested quality in every case, and some download components (like audio) can be marked as `"Not available"` when a suitable option isn’t present. For enterprise-scale needs or custom configurations, reach out and we'll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes, Apify offers a free tier with monthly usage credits. You can use it to run small tests and validate output fields like `found_resolution` and `download_links` before scaling up. #### Do I need to log in or create an account on Facebook? No login is required by the actor itself. It processes the URLs you supply and extracts publicly available video information needed to produce the dataset output. #### How accurate is the extracted data? The actor returns `general_metadata` and resolution results based on the source data available from each provided video URL. Your selected quality outcome is reflected directly in `found_resolution`, so you can verify what you actually got. #### How many results can I get per run? You can provide multiple entries in `video_urls`, and the actor will output one or more dataset records per input URL (including cases where a URL contains multiple entries). There’s no hard-coded limit in the input schema beyond what your run and Apify environment supports. #### How fresh is the data? Data is fetched at run time, so the output reflects what was available when the actor processed your URLs. If the source content changes later, you’ll see different results on a subsequent run. #### Is this legal? Does it comply with GDPR / CCPA? Use of the actor depends on your use case and the applicable laws where you operate. The actor works with **publicly available data** from the URLs you provide; you’re responsible for compliance with GDPR, CCPA, and relevant platform terms. #### Can I export to Google Sheets or Excel? Yes. You can export the dataset from the Apify dashboard, and you can also integrate with workflows that sync dataset outputs into tools like spreadsheets. #### Can I schedule this to run automatically? Yes. You can schedule Apify actor runs using Apify scheduling features so it runs automatically on a defined cadence (for example, to refresh a media library). #### Can I access results via the API? Yes. Since results are written to the Apify dataset, you can retrieve them via the Apify API as part of your automation pipeline. #### What happens when the actor encounters an error? If a URL fails, the actor still pushes a dataset record containing at least `video_url` and an error message (`error`). This allows you to continue analyzing successful URLs without losing everything from the run. *** ### Get Help & Use Responsibly Got a question about Facebook Video Downloader Actor or a feature you'd like added? Reach out at , and we’ll help with onboarding, workflow ideas, or improvements based on your feedback. We’re actively maintaining this actor to keep results consistent for bulk Facebook video downloader and Facebook video download helper use cases, and we can share guidance for setting up your input payload. *** **publicly available data** only: this actor does not access private accounts, login-gated pages, or password-protected content. You’re responsible for using the output in compliance with GDPR, CCPA, and the platform’s Terms of Service. For data removal requests, contact . Use responsibly, ethically, and only for lawful 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("scrapeflux/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("scrapeflux/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 scrapeflux/facebook-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeflux/facebook-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Video Downloader", "description": "Facebook Video Downloader lets you save publicly available Facebook videos quickly and efficiently. Download videos for content research, social media monitoring, archiving, marketing analysis, and offline viewing with a fast, reliable, and easy-to-use solution.", "version": "1.0", "x-build-id": "gWzSPDjBKbnQ8u4vD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeflux~facebook-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeflux-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/scrapeflux~facebook-video-downloader/runs": { "post": { "operationId": "runs-sync-scrapeflux-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/scrapeflux~facebook-video-downloader/run-sync": { "post": { "operationId": "run-sync-scrapeflux-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 } } } } } } } } } } ```