# Facebook Video Downloader Scraper (`soft_alexist/facebook-video-downloader-scraper`) Actor Download direct video URLs from Facebook Reels and posts with a simple scraper. Extract high-quality video links effortlessly — perfect for content creators, researchers, and digital marketers who need reliable video access. - **URL**: https://apify.com/soft\_alexist/facebook-video-downloader-scraper.md - **Developed by:** [Soft Alexist](https://apify.com/soft_alexist) (community) - **Categories:** Automation, Developer tools, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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: Extract Video URLs Instantly --- ### Why Download Facebook Videos Programmatically? Facebook hosts billions of videos, from viral Reels to important educational content. While Facebook's native download options are limited, automated scraping enables legitimate use cases: archiving personal content, analyzing video metrics, conducting social media research, or integrating videos into custom platforms. The **Facebook Video Downloader Scraper** streamlines this process by extracting direct video download URLs from any public Facebook post or Reel. --- ### Overview The **Facebook Video Downloader Scraper** is a lightweight, efficient tool designed to extract downloadable video links from Facebook content. It works with: - **Facebook Reels** — short-form video content - **Video posts** — standard video uploads to pages and profiles - **Public content only** — respects privacy settings Key features include batch URL processing, configurable error handling, and reliable extraction of direct download links. This scraper is ideal for: - **Content creators** archiving their own videos - **Researchers** studying video trends and performance - **Digital strategists** monitoring competitor content - **Media professionals** integrating Facebook videos into workflows --- ### Input Configuration The scraper accepts a JSON configuration object to define which videos to process: ```json { "urls": [ "https://www.facebook.com/reel/1723419552326092", "https://www.facebook.com/watch/?v=VIDEO_ID" ], "ignore_url_failures": true } ```` #### Input Field Definitions | Field | Type | Description | |---|---|---| | `urls` | Array of strings | List of Facebook video URLs to scrape. Supports individual Reels, video posts, or Watch platform links. Paste one URL per line, or use bulk edit to add multiple URLs at once. | | `ignore_url_failures` | Boolean | If `true`, the scraper continues processing if certain URLs fail (e.g., deleted videos, private content). If `false`, the entire run stops on the first failure. Default: `true`. | **Requirements:** - URLs must be publicly accessible (not age-restricted or private) - Video must not be removed or region-locked - Reel URLs typically follow: `https://www.facebook.com/reel/VIDEO_ID` - Standard video posts: `https://www.facebook.com/PAGE/videos/VIDEO_ID` or `https://www.facebook.com/watch/?v=VIDEO_ID` *** ### Output Format **Sample output** ```json { "download_url": "https://ytdlp.online/api/v1/file/401K%20views%20%C2%B7%207.8K%20reactions%20%EF%BD%9C%20%EC%9A%B0%EB%A6%AC%20%EC%9B%90%EB%94%9C%20%ED%8E%98%EC%9D%B4%EC%A6%88%20%23LCK%20%23MSI2026%20%23CallYourShot%20%EF%BD%9C%20LCK.mp4", "from_url": "https://www.facebook.com/reel/1723419552326092" } ``` The scraper returns a single, essential field per video: #### Download URL | Field | Meaning | Example | |---|---|---| | `Download URL` | Direct link to the video file | **What this means:** - The `Download URL` is a temporary, direct HTTP link to the video file - It can be used with standard download tools (wget, curl) or video players - **Links expire after a period** (typically hours to days), so download immediately - Quality may vary; Facebook often provides multiple resolutions, and the scraper returns the highest available - This URL bypasses Facebook's UI and retrieves the raw video asset **Important:** - These are time-limited direct links — save videos quickly after scraping - The URL structure changes frequently; do not hard-code or cache these links - Use the URL immediately or re-scrape the video to obtain a fresh link *** ### How to Use 1. **Collect video URLs** — Navigate to a Facebook Reel or video post and copy the URL from your browser's address bar. 2. **Paste into configuration** — Add URLs to the `urls` array in the input JSON, one per entry. 3. **Set error handling** — Leave `ignore_url_failures: true` unless you need strict validation. 4. **Run the scraper** — Execute the actor and wait for completion. 5. **Download videos** — Use the returned `Download URL` with a video downloader, browser, or media application. 6. **Act quickly** — URLs are temporary; download or process videos within hours of scraping. **Troubleshooting:** - **No URL returned:** Video may be private, deleted, or region-locked. Try accessing the URL directly in your browser. - **Failed URLs:** Enable `ignore_url_failures: true` to skip problematic links and continue with others. - **Expired links:** If a URL fails later, re-run the scraper to obtain a fresh download link. *** ### Use Cases & Applications - **Personal archiving:** Back up videos you've created before they're accidentally deleted - **Social research:** Analyze trending video content and performance metrics across regions - **Content curation:** Aggregate videos for websites, presentations, or educational materials - **Workflow integration:** Automate video downloads for bulk processing or encoding - **Competitor analysis:** Monitor video strategies of brands and influencers The Facebook Video Downloader Scraper eliminates manual, repetitive downloading—especially valuable when working with dozens of videos. *** ### Legal & Ethical Considerations Always ensure your use complies with: - **Facebook's Terms of Service** — Automated scraping may violate ToS depending on use - **Copyright laws** — Only download videos you have rights to (your own content, licensed, public domain) - **Regional regulations** — Some jurisdictions restrict circumventing platform restrictions - **Creator consent** — Respect creators' wishes regarding redistribution > **Disclaimer:** This scraper is intended for legitimate, legal purposes only. Users are responsible for ensuring compliance with all applicable laws and platform policies. *** ### Conclusion The **Facebook Video Downloader Scraper** provides a simple, programmatic way to extract video links from Facebook. With straightforward input, instant results, and support for batch processing, it empowers creators and researchers to work with video content efficiently. Remember to download promptly and respect copyright — then start scraping with confidence. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the videos urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## Actor input object example ```json { "urls": [ "https://www.facebook.com/reel/1723419552326092" ], "ignore_url_failures": true } ``` # 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 = { "urls": [ "https://www.facebook.com/reel/1723419552326092" ], "ignore_url_failures": true }; // Run the Actor and wait for it to finish const run = await client.actor("soft_alexist/facebook-video-downloader-scraper").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 = { "urls": ["https://www.facebook.com/reel/1723419552326092"], "ignore_url_failures": True, } # Run the Actor and wait for it to finish run = client.actor("soft_alexist/facebook-video-downloader-scraper").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 '{ "urls": [ "https://www.facebook.com/reel/1723419552326092" ], "ignore_url_failures": true }' | apify call soft_alexist/facebook-video-downloader-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=soft_alexist/facebook-video-downloader-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Video Downloader Scraper", "description": "Download direct video URLs from Facebook Reels and posts with a simple scraper. Extract high-quality video links effortlessly — perfect for content creators, researchers, and digital marketers who need reliable video access.", "version": "0.0", "x-build-id": "U6Rdg8pfWfNS7urmx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/soft_alexist~facebook-video-downloader-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-soft_alexist-facebook-video-downloader-scraper", "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/soft_alexist~facebook-video-downloader-scraper/runs": { "post": { "operationId": "runs-sync-soft_alexist-facebook-video-downloader-scraper", "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/soft_alexist~facebook-video-downloader-scraper/run-sync": { "post": { "operationId": "run-sync-soft_alexist-facebook-video-downloader-scraper", "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": { "urls": { "title": "URLs of the videos urls to scrape", "type": "array", "description": "Add the URLs of the videos urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." } } }, "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 } } } } } } } } } } ```