# Facebook Reels Downloader Pro (`codenest/facebook-reels-downloader-pro`) Actor

🚀 Download Facebook Reels instantly! Get 1080p HD videos, separate audio tracks, and secure Apify Key-Value Store URLs. Perfect for marketers 📈, content creators 🎬, and developers 💻. Enjoy encrypted storage, permanent download links, and reliable access to all your media files.

- **URL**: https://apify.com/codenest/facebook-reels-downloader-pro.md
- **Developed by:** [CodeNest](https://apify.com/codenest) (community)
- **Categories:** Videos, Social media, Developer tools
- **Stats:** 18 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$9.00/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 Reels Downloader Pro - Advanced Media Extraction Solution

**🚀 Download Facebook Reels with professional precision using our enterprise-grade Facebook Reels Downloader Pro! This powerful Apify actor delivers high-quality video downloads, comprehensive metadata, and secure storage through Apify's Key-Value Store.**

---

### 📖 Overview
The **Facebook Reels Downloader Pro** enables seamless downloading of Facebook Reels content with enterprise-level reliability. Whether you're archiving content, analyzing trends, or repurposing videos, this **Facebook Reels Downloader Pro** actor provides everything you need for professional media extraction.

#### 🔑 Key-Value Store Benefits
- **Secure Storage**: All downloads are safely stored in Apify's encrypted Key-Value Store
- **Direct Access**: Get permanent, shareable download URLs
- **Reliable Links**: No broken URLs - content remains accessible
- **Organized Management**: Easy tracking and management of downloaded files

---

### ⚡ Core Capabilities

#### 🎬 Media Options
- **Multiple Resolutions**: 1080p, 720p, 540p quality options
- **Separate Audio Tracks**: Isolated M4A audio files
- **Combined Videos**: Audio+video merged files
- **High-Quality Thumbnails**: Multiple preview images
- **Bulk Processing**: Handle multiple URLs simultaneously

#### 📊 Metadata Excellence
- **Duration Tracking**: Precise timing with decimal accuracy
- **Format Detection**: Automatic container and codec identification
- **Quality Variants**: Multiple resolution options
- **CDN Access**: Direct Facebook CDN links

#### 🛠 Advanced Features
- **Key-Value Integration**: Secure Apify storage for all downloads
- **Multiple Formats**: Video-only, audio-only, and combined variants
- **Quality Selection**: Auto-detection of best available quality
- **Proxy Support**: Built-in IP rotation capabilities

---

### 🎯 Input Configuration

Configure your **Facebook Reels Downloader Pro** with this simple JSON input:

```json
{
  "key_value": true,
  "reel_urls": [
    {
      "url": "https://web.facebook.com/reel/1831270064408357",
      "method": "GET"
    }
  ]
}
````

#### 📋 Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key_value` | Boolean | Yes | Enable Apify Key-Value Store for secure downloads |
| `reel_urls` | Array | Yes | Array of Facebook Reel URLs to process |
| `url` | String | Yes | Valid Facebook Reel URL (reel/ format) |
| `method` | String | Yes | HTTP method (GET recommended) |

***

### 📤 Output Structure

The **Facebook Reels Downloader Pro** returns comprehensive output with secure Key-Value Store URLs:

```json
[
  {
    "url": "https://www.facebook.com/reel/1831270064408357/",
    "duration": 20.165,
    "reel_download_url": "https://api.apify.com/v2/key-value-stores/lhIdIrCPfawRHfMxT/records/fb_reel_1831270064408357.mp4",
    "audio_download_url": "https://api.apify.com/v2/key-value-stores/lhIdIrCPfawRHfMxT/records/fb_reel_audio_1831270064408357.m4a",
    "thumbnail_url": "https://api.apify.com/v2/key-value-stores/lhIdIrCPfawRHfMxT/records/fb_reel_thumb_1831270064408357.jpg",
    "format_id": "hd",
    "ext": "mp4",
    "video_variants": [...],
    "video_with_audio_variants": [...],
    "audio_variants": [...],
    "thumbnails": [...]
  }
]
```

#### 📊 Output Field Documentation

**Core Metadata**
| Field | Description |
|-------|-------------|
| `url` | Original Facebook Reel URL |
| `duration` | Video length in seconds (decimal precision) |
| `format_id` | Quality identifier (hd, sd, etc.) |
| `ext` | File extension (mp4, m4a, jpg) |

**Key-Value Store Downloads**
| Field | Description |
|-------|-------------|
| `reel_download_url` | Secure Apify KV Store URL for video |
| `audio_download_url` | Secure Apify KV Store URL for audio |
| `thumbnail_url` | Secure Apify KV Store URL for thumbnail |

**Media Variants**
| Field | Description |
|-------|-------------|
| `video_variants` | Video-only streams in multiple resolutions |
| `video_with_audio_variants` | Combined audio+video files |
| `audio_variants` | Separate audio tracks |
| `thumbnails` | Multiple thumbnail options |

***

### 🎚 Quality Tiers Available

The **Facebook Reels Downloader Pro** automatically detects and provides:

1. **Ultra HD** - 1920x1080 (1080p) maximum quality
2. **High Definition** - 1280x720 (720p) balanced quality
3. **Standard Definition** - 960x540 (540p) optimized streaming
4. **Audio Only** - Separate M4A audio tracks

***

### 🔧 Technical Features

#### 🗂 Key-Value Store Integration

- **Secure Storage**: Encrypted file storage with access control
- **Permanent URLs**: Download links that don't expire
- **Easy Sharing**: Distribute content without re-uploading
- **Organization**: Structured storage for multiple downloads

#### 🎥 Format Support

- **Multiple Resolutions**: 1080p, 720p, 540p automatic detection
- **Audio Extraction**: Clean M4A audio track separation
- **Thumbnail Generation**: High-quality preview images
- **Container Formats**: MP4 video and M4A audio support

#### ⚡ Performance

- **Direct CDN Access**: Bypass limitations with Facebook's CDN
- **Quality Fallback**: Automatic best-quality selection
- **Batch Processing**: Efficient multiple URL handling
- **Error Handling**: Comprehensive failure recovery

***

### 💼 Use Cases

#### 🎨 Content Creators

- Archive your Facebook Reels content safely
- Repurpose videos for other platforms
- Backup important business content

#### 📊 Digital Marketers

- Analyze competitor Reels strategies
- Create compilations and trend reports
- Monitor brand mentions and content

#### 🔬 Researchers

- Study viral content patterns
- Analyze engagement metrics
- Track content distribution

#### 💻 Developers

- Build applications with Facebook Reels integration
- Create content management systems
- Develop analytics platforms

***

### ❓ Why Choose Facebook Reels Downloader Pro?

#### ✅ Key Advantages

- **Secure Storage**: All downloads protected in Apify's Key-Value Store
- **Highest Quality**: Multiple resolution options up to 1080p
- **Comprehensive Data**: Full metadata and multiple format variants
- **Reliable Performance**: Enterprise-grade extraction technology

#### 🔒 Security & Reliability

- **Encrypted Storage**: Files securely stored in Apify KV Store
- **Access Control**: Controlled download URL access
- **Uptime Guarantee**: Reliable Apify infrastructure
- **Regular Updates**: Maintained for Facebook changes

***

### ⚠️ Limitations

- Requires public Facebook Reels content
- Subject to Facebook's rate limiting
- Geographic restrictions may apply

***

### 🔗🛠 Related Actors (Complete Social Media Suite)

#### 📘 Facebook Tools

- [Facebook Video Transcript Scraper](https://apify.com/codenest/facebook-video-transcript-scraper)
- [Facebook Video Downloader Pro](https://apify.com/codenest/facebook-video-downloader-pro)
- [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, bulk processing, or custom integrations** with your **Facebook Reels Downloader Pro**?

✉️ Email **<codenest2.0@gmail.com>** for tailored solutions!

***

**🚀 Start using the most advanced Facebook Reels Downloader Pro today and experience professional-grade media extraction with secure Key-Value Store integration!**

# Actor input Schema

## `reel_urls` (type: `array`):

List of public Facebook Reels URLs. Also supports fb.watch and will resolve share/v links.

## `key_value` (type: `boolean`):

Enable or disable storing reel videos, audio, and thumbnails in the Apify key-value store.

## Actor input object example

```json
{
  "reel_urls": [
    {
      "url": "https://web.facebook.com/reel/1831270064408357"
    }
  ],
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "reel_urls": [
        {
            "url": "https://web.facebook.com/reel/1831270064408357"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("codenest/facebook-reels-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "reel_urls": [{ "url": "https://web.facebook.com/reel/1831270064408357" }] }

# Run the Actor and wait for it to finish
run = client.actor("codenest/facebook-reels-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"
    }
  ]
}' |
apify call codenest/facebook-reels-downloader-pro --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=codenest/facebook-reels-downloader-pro",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Facebook Reels Downloader Pro",
        "description": "🚀 Download Facebook Reels instantly! Get 1080p HD videos, separate audio tracks, and secure Apify Key-Value Store URLs. Perfect for marketers 📈, content creators 🎬, and developers 💻. Enjoy encrypted storage, permanent download links, and reliable access to all your media files.",
        "version": "0.0",
        "x-build-id": "TiAZnxUQeo4ZdVfR4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/codenest~facebook-reels-downloader-pro/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-codenest-facebook-reels-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-reels-downloader-pro/runs": {
            "post": {
                "operationId": "runs-sync-codenest-facebook-reels-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-reels-downloader-pro/run-sync": {
            "post": {
                "operationId": "run-sync-codenest-facebook-reels-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",
                "required": [
                    "reel_urls"
                ],
                "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"
                            ]
                        }
                    },
                    "key_value": {
                        "title": "Store files in the key-value store?",
                        "type": "boolean",
                        "description": "Enable or disable storing reel videos, audio, and thumbnails in the Apify key-value store.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
