# Facebook Video Downloader (`scraperoka/facebook-video-downloader`) Actor 📹✨ Need a Facebook video fast? Our Facebook Video Downloader lets you save videos in seconds with simple, safe downloads. 🚀 Free, easy, and high-quality—perfect for sharing, offline viewing & saving memories! 🔥 - **URL**: https://apify.com/scraperoka/facebook-video-downloader.md - **Developed by:** [Scraperoka](https://apify.com/scraperoka) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 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 ⚡ Manually downloading Facebook videos one by one is slow and messy—especially when you need specific resolutions for a content workflow. **Facebook Video Downloader Actor** extracts video details and download links from your provided Facebook video URLs, in a single batch run. This Facebook video downloader actor is ideal for marketers, editors, researchers, and growth teams who want a smooth “download Facebook videos” workflow at scale—thousands of records in minutes. --- ### What You Get: Sample Output Here’s a sample record from a single run: ```json { "video_url": "https://www.facebook.com/share/v/18zL4zNBNJ/", "requested_resolution": "1080p", "video_type": "reel", "general_metadata": { "title": "Reel Title Example", "author": "Example Page Name", "thumbnail": "https://example.com/thumbnail.jpg", "duration": 42, "channel_name": "Example Page Name", "video_language": "en", "video_age_restriction": 13 }, "found_resolution": "720p", "note": "Your requested resolution was not found; highest available resolution selected.", "download_links": { "merged_video": "https://example.com/merged_video_720p.mp4", "video": "https://example.com/video_only_720p.mp4", "audio": "https://example.com/audio_abr_128k.mp3" } } ```` **Output Fields** | Field | Type | What It Tells You | |---|---|---| | `video_url` | string | The Facebook URL that was processed for this record | | `requested_resolution` | string | The resolution you asked for (or the “Highest Available” fallback) | | `video_type` | string | Classifies the content as `reel` (under 60 seconds) or `long video` | | `general_metadata` | object | A compact metadata object (only includes keys that have values) like title/author/thumbnail/duration | | `found_resolution` | string | The closest resolution the actor selected (e.g., `720p`, or `Unknown`) | | `note` | string | A human-friendly status explaining whether your requested resolution was found | | `download_links` | object | Selected media URLs, including merged video and/or separate video + audio | | `error` | string | Only returned in failure cases to explain what went wrong (when processing fails) | | `download_links.audio` | string | Audio download URL when available; otherwise set to `"Not available"` | Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard. *** ### Why Facebook Video Downloader Actor? There are a lot of ways to pull data from Facebook content—here’s what sets Facebook Video Downloader Actor apart. #### Resolution-aware selection (with friendly notes) You choose `requested_resolution`, and the actor selects the closest available option for each video. It also adds a clear `note` so you know whether your requested resolution was actually found or not. #### Structured, integration-ready output Results are written as consistent JSON objects with `general_metadata`, a `found_resolution`, and `download_links`. This makes it easy to feed into downstream workflows—content pipelines, QA checks, archiving, and analytics. #### Built for batch runs over single clicks The actor accepts an array of `video_urls`, then processes each one and pushes each result as it’s ready. That’s the difference between “download Facebook videos manually” and running a full batch with one job. #### Resilient processing and clear error records If a particular input URL fails, the actor pushes an error record for that URL instead of silently skipping it. You’ll see failures as explicit output items in your dataset. *** ### Configuring Your Run Drop this into your `input.json` to get started: ```json { "video_urls": [ { "url": "https://www.facebook.com/share/v/18zL4zNBNJ/" }, { "url": "https://www.facebook.com/share/r/168H2dZLPu/" } ], "requested_resolution": "1080p" } ``` | Parameter | Required | What It Does | |---|---|---| | `video_urls` | ✅ | A list of Facebook video URLs to process | | ↳ `video_urls[].url` | ✅ | The direct URL of the Facebook video you want to download | | `requested_resolution` | ⬜ | Select the desired resolution (e.g., `1080p`, `720p`, `480p`, etc.). If omitted, it defaults to `1080p` | Allowed `requested_resolution` values: `1080p`, `720p`, `640p`, `540p`, `480p`, `360p`, `270p`, `240p`. *** ### Core Capabilities #### Batch processing from `video_urls` Provide one or more Facebook video URLs, and the Facebook Video Downloader Actor processes them one by one and outputs a record per URL. This is a practical fit for “download Facebook videos” tasks when you’re working through a content slate. #### Video type detection for quick sorting Each result includes `video_type`, set to `reel` when duration is under 60 seconds, and `long video` otherwise. This helps you separate reel downloads from longer clips without extra manual steps. #### Metadata packaged in `general_metadata` For each video, the actor returns a `general_metadata` object containing only the metadata keys that have values. That includes fields like title, author (uploader), thumbnail, duration, location, channel name, language, and age restriction—when available. #### Resolution selection with `found_resolution` + `note` The actor selects the closest matching resolution and reports it in `found_resolution`. The `note` field explains whether the requested resolution was found or whether it had to fall back to the highest available resolution. #### Download links in `download_links` Each record includes `download_links` with the media URLs the actor selected. It may provide `merged_video` for a combined stream, and also include `video` and `audio` when applicable (with `audio` explicitly set to `"Not available"` when audio isn’t present). #### Clear per-URL error handling If something goes wrong while processing a URL, you’ll get a dataset record containing the `video_url` and an `error` string. This makes it easy to re-run only the failed items—useful for a Facebook video downloader tool actor workflow. *** ### Who Gets the Most Out of This Here's how different teams put Facebook Video Downloader Actor to work: **Content editors and media teams** — They batch-download Facebook reel and long video assets and keep everything organized by resolution using `requested_resolution`, `found_resolution`, and `video_type`. The `note` field makes QA quick when a requested resolution isn’t available. **Performance marketers** — They rebuild campaigns by pulling video variants at consistent quality, then store the results with `general_metadata` (like title and author). This supports faster creative review loops and cleaner asset management for ad iteration. **Researchers and archivists** — They extract structured metadata and download links from publicly available sources so they can analyze content at scale. The dataset output makes it straightforward to compare availability across different resolutions and content types (reels vs long videos). **Automation engineers** — They treat the actor as a data step: pass in a list of `video_urls`, run the job, then consume structured `download_links` and `general_metadata` downstream. This makes the Facebook reel downloader actor workflow easy to integrate into pipelines and scheduled runs. *** ### Step-by-Step: How to Use It No coding needed. Here's how to run Facebook Video Downloader Actor from start to finish: 1. **Open the actor on Apify** — go to [console.apify.com](https://console.apify.com) and open **Facebook Video Downloader Actor**. 2. **Enter your inputs** — add `video_urls` (one or more Facebook URLs) and optionally set `requested_resolution`. 3. **Configure proxy settings** — enable or adjust proxy support in the Apify UI for reliable runs at scale. 4. **Hit Run and watch the live log** — monitor progress while each URL is processed. 5. **View results in the dataset tab** — each processed URL appears as a structured record with `found_resolution`, `note`, and `download_links`. 6. **Export as JSON, CSV, or Excel** — download the dataset from the Apify dashboard in your preferred format. The whole process takes under 5 minutes to set up. *** ### Integrations & Export Options Once your data is collected, Facebook Video Downloader Actor plugs directly into your existing workflow. You can export results from the Apify dataset tab in JSON, CSV, or Excel format. This makes it easy to work with a Facebook video downloader app actor-style workflow—store, filter, and share results with your team. For deeper automation, you can connect your run to other tools using Apify’s API capabilities (see [apify.com/docs/api](https://apify.com/docs/api)) and typical Apify integrations like Zapier/Make to move output into CRMs, spreadsheets, or internal systems. You can also automate recurring runs with scheduled triggers on Apify. *** ### Pricing & Free Trial Facebook Video Downloader Actor runs on the Apify platform, which offers a **free tier** to help you test without committing. You’ll use Apify compute (billed per Actor compute unit/usage model) as you run jobs, while benefiting from the ability to process multiple `video_urls` in one run. Start for free at [apify.com](https://apify.com) and scale when you're ready. *** ### Reliability & Performance | What We Handle | How | |---|---| | Public web data processing | Extracts video details without requiring user interaction per video | | Resolution variability | Selects the closest match and reports it via `found_resolution` and `note` | | Long vs short content differences | Uses `video_type` (`reel` vs `long video`) to guide resolution handling | | Failure visibility | Pushes an error record for failed `video_url` inputs | | Scaling to batch lists | Processes each item and writes results to your dataset | **Limitations:** This actor operates on publicly accessible video pages/links you provide, and results depend on what’s available for each specific video (for example, audio availability). Private, login-gated, or inaccessible content cannot be processed. For enterprise-scale runs, contact us to discuss custom configurations. *** ### Frequently Asked Questions #### Is there a free plan or trial? Yes—Apify provides a free tier so you can test Facebook Video Downloader Actor without an immediate paid commitment. Availability and exact credit amounts depend on your Apify account and current plan. #### Do I need to log in to Facebook to use this? No. The actor processes the Facebook video URLs you provide and returns structured results in the dataset. You don’t need to manage Facebook credentials to run the actor. #### How accurate is the data? The output is accurate to what the actor can retrieve from the provided video URLs. Resolution availability varies by video, so `found_resolution` and `note` reflect what was actually selected. #### How many results can I get per run? You can submit multiple entries via `video_urls`, and the actor will produce one dataset record per processed item (or an error record for failures). The practical limit depends on your Apify run settings and compute availability. #### How often is the data updated / how fresh is it? The data is captured at run time. If you re-run the actor later with the same `video_urls`, you’ll get a new snapshot based on the current publicly available video info. #### Is this legal? Does it comply with GDPR / CCPA? You should only use this actor for data that is **publicly available data** from the sources you provide, and you must comply with GDPR, CCPA, platform terms, and any other applicable laws. The actor does not handle your compliance decisions—your use case does. #### Can I export results to Google Sheets or Excel? Yes. You can export your dataset as JSON, CSV, or Excel directly from the Apify dashboard. From there, moving into Google Sheets or similar tools is straightforward. #### Can I run this on a schedule automatically? Yes—Apify supports running actors on scheduled runs. Once you’ve set up your inputs, you can automate repeat executions for updated batches. #### Can I access this via API? Yes. You can use the Apify API to trigger runs programmatically and retrieve results. See [apify.com/docs/api](https://apify.com/docs/api) for details. #### What happens if the actor hits an error? If processing fails for a specific `video_url`, the actor pushes an output record containing the `video_url` and an `error` string. Your dataset will still contain results for other successfully processed inputs. *** ### Need Help or Have a Request? Got a question about Facebook Video Downloader Actor or want a new feature added? Reach out at . We’re happy to help with run questions, and we actively maintain this actor based on feedback. If you’d like improvements like batch upload formats or better completion signaling, tell us what you need. *** ### Disclaimer & Responsible Use *Facebook Video Downloader Actor is the fastest, most reliable way to prepare structured video download info from public Facebook URLs—start your free run today.* This actor collects **publicly available data** from the Facebook video URLs you provide. It does not access private accounts, login-gated content, or password-protected pages. You are responsible for using the output in compliance with GDPR, CCPA, platform Terms of Service, and all applicable regulations. If you need data removal, 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("scraperoka/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("scraperoka/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 scraperoka/facebook-video-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperoka/facebook-video-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Video Downloader", "description": "📹✨ Need a Facebook video fast? Our Facebook Video Downloader lets you save videos in seconds with simple, safe downloads. 🚀 Free, easy, and high-quality—perfect for sharing, offline viewing & saving memories! 🔥", "version": "1.0", "x-build-id": "fKTuKXyWNr14MaO4s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperoka~facebook-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperoka-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/scraperoka~facebook-video-downloader/runs": { "post": { "operationId": "runs-sync-scraperoka-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/scraperoka~facebook-video-downloader/run-sync": { "post": { "operationId": "run-sync-scraperoka-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 } } } } } } } } } } ```