# Facebook Reels scraper (`datapilot/facebook-reels-scraper`) Actor

It collects title, description, uploader, views, likes, thumbnail, duration, resolution, and a direct video link. Supports residential proxies, async processing, and outputs structured JSON results.

- **URL**: https://apify.com/datapilot/facebook-reels-scraper.md
- **Developed by:** [Data Pilot](https://apify.com/datapilot) (community)
- **Categories:** Videos
- **Features:** Limited permissions
- **Stats:** 44 total users, 5 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 scraped 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Facebook Reels Scraper

🚀 **Facebook Reels Scraper** is a powerful Apify Actor designed to scrape **Facebook Reels data** from Facebook video URLs. This tool provides comprehensive **Facebook Reels information**, including video titles, descriptions, view counts, like counts, and direct download links for any Facebook Reel. Whether you're analyzing **Facebook Reels trends**, conducting social media research, or archiving **Facebook Reels content**, the Facebook Reels Scraper delivers detailed **Facebook Reels data** efficiently.

With residential proxy support, the Facebook Reels Scraper ensures reliable and undetected scraping of **Facebook Reels content**. It focuses on key **Facebook Reels metrics** like engagement data and video quality, making it an essential tool for **Facebook Reels analysis** and content strategy.

### 🔥 Features

- **Comprehensive Facebook Reels Extraction** – Scrapes detailed **Facebook Reels data**, including titles, descriptions, uploader information, and engagement metrics for any Facebook video URL.
- **Direct Download Links** – Extracts direct video URLs for **Facebook Reels** to enable easy downloading and archiving.
- **Metadata Enrichment** – Provides **Facebook Reels metadata** like view counts, like counts, duration, and resolution for in-depth **Facebook Reels analysis**.
- **Batch Processing** – Processes multiple **Facebook Reels URLs** in a single run for efficient **Facebook Reels data collection**.
- **Residential Proxy Support** – Utilizes Apify's residential proxies to bypass restrictions and ensure high success rates for **Facebook Reels scraping**.
- **Error Handling** – Robust logging and fallback mechanisms for failed **Facebook Reels scrapes**.
- **Dataset Integration** – Automatically uploads **Facebook Reels data** to your Apify dataset for easy export and analysis.

***

### ⚙️ How It Works

The Facebook Reels Scraper takes one or more Facebook video URLs as input and usesp to extract metadata and direct download links without downloading the full **Facebook Reels** initially. It configures  with residential proxies for reliable scraping. The scraper returns structured **Facebook Reels data** on success or error details on failure, providing a fast way to gather **Facebook Reels** for research and analysis.

**Key Processing Steps:**

1. **URL Validation** – Parse and validate Facebook Reels URLs
2. **Metadata Extraction** – Extract video titles, descriptions, uploader info
3. **Download Link Generation** – Generate direct download URLs via
4. **Engagement Metrics** – Extract view counts, like counts, comments
5. **Metadata Enrichment** – Gather resolution, duration, thumbnail data
6. **Proxy Configuration** – Configure residential proxies for reliability
7. **Data Export** – Push results to dataset in JSON format

**Key benefits for Facebook Reels analysis:**

- Track **Facebook Reels engagement metrics** like views and likes.
- Analyze **Facebook Reels performance** for content optimization.
- Build **Facebook Reels databases** for social media research.
- Monitor video trends and viral content.
- Archive important Facebook Reel content.

***

### 📥 Input

The scraper accepts the following input parameters:

| Field                  | Type    | Default                                               | Description |
|------------------------|---------|-------------------------------------------------------|-------------|
| `urls`                 | array   | required                                              | List of Facebook video URLs to scrape Facebook Reels data from (e.g., `"https://www.facebook.com/reel/..."`). |
| `proxyConfiguration`   | object  | `{"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}` | Proxy settings, including useApifyProxy and apifyProxyGroups. |

**Example input JSON:**

```json
{
  "urls": [
    "https://www.facebook.com/reel/example1",
    "https://www.facebook.com/reel/example2",
    "https://www.facebook.com/watch/?v=example3"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

***

### 📤 Output

The scraper outputs detailed **Facebook Reels data** in JSON format for each URL. Each record includes:

| Field          | Type    | Description |
|----------------|---------|-------------|
| `id`           | string  | Unique ID of the Facebook Reel. |
| `title`        | string  | Title of the Facebook Reel. |
| `description`  | string  | Description of the Facebook Reel. |
| `uploader`     | string  | Uploader/page name of the Facebook Reel. |
| `duration`     | integer | Duration of the Facebook Reel in seconds. |
| `view_count`   | integer | View count for the Facebook Reel. |
| `like_count`   | integer | Like count for the Facebook Reel. |
| `thumbnail`    | string  | Thumbnail image URL for the Facebook Reel. |
| `video_url`    | string  | Direct download URL for the Facebook Reel. |
| `resolution`   | string  | Resolution of the Facebook Reel (e.g., `"1080x1920"`). |
| `timestamp`    | string  | ISO timestamp of the scrape. |

**Example output for successful Facebook Reels extraction:**

```json
{
  "id": "123456789",
  "title": "Amazing Facebook Reel",
  "description": "Check out this amazing content!",
  "uploader": "example_page",
  "duration": 30,
  "view_count": 50000,
  "like_count": 2500,
  "thumbnail": "https://example.com/thumbnail.jpg",
  "video_url": "https://example.com/video.mp4",
  "resolution": "1080x1920",
  "timestamp": "2025-02-14T12:00:00Z"
}
```

**Example error response:**

```json
{
  "url": "https://www.facebook.com/reel/invalid",
  "status": "failed",
  "error": "Reel not accessible or has been removed",
  "timestamp": "2025-02-14T12:00:00Z"
}
```

**Example summary record:**

```json
{
  "summary": true,
  "total_urls": 3,
  "successful_scrapes": 2,
  "failed_scrapes": 1,
  "total_views": 150000,
  "total_likes": 7500,
  "completed_at": "2025-02-14T12:35:00Z"
}
```

***

### 🧰 Technical Stack

- **Proxy Support:** Apify Proxy with RESIDENTIAL support for reliability
- **Data Processing:** JSON formatting, metadata enrichment
- **Platform:** Apify Actor – serverless, scalable, integrated with Dataset and Key‑Value Store
- **Deployment:** One‑click run on Apify Console or via REST API

***

### 🎯 Use Cases

- **Reels Analytics** – Analyze Facebook Reels performance and engagement metrics.
- **Content Research** – Research trending Reels and successful content strategies.
- **Competitor Analysis** – Analyze competitor Reels and engagement patterns.
- **Trend Analysis** – Identify trending topics and viral Reels.
- **Content Archiving** – Archive important or viral Facebook Reels.
- **Marketing Research** – Research effective Reels marketing strategies.
- **Influencer Analysis** – Track influencer Reels performance.
- **Brand Monitoring** – Monitor brand-related Reels and engagement.
- **User Research** – Understand user preferences through Reels engagement.
- **Social Media Strategy** – Develop Reels strategy based on data insights.
- **Video Database Building** – Build Reels databases for research.
- **Engagement Tracking** – Track engagement metrics over time.
- **Creative Research** – Research creative trends and techniques.
- **Academic Research** – Collect Reels data for research studies.

***

### 🚀 Quick Start

1. **Open in Apify Console** – visit the Actor page and click Try for free.
2. **Enter Facebook Reels URLs** – provide one or more Facebook Reels URLs.
3. **Enable residential proxies** – enabled by default for reliable scraping.
4. **Click Start** – the Actor will extract Reels data and direct links.
5. **View Results** – check the dataset for extracted Reels metadata.
6. **Download Videos** – use the provided direct URLs to download Reels.
7. **Analyze Data** – examine engagement metrics and performance data.
8. **Export** – download the results as JSON, CSV, or Excel.

You can also call this Actor programmatically via Apify SDK or REST API – ideal for automated Reels monitoring and analysis.

***

### 💎 Why This Scraper?

| Feature | Benefit |
|---------|---------|
| ✅ Direct links | Get video URLs without full downloads initially. |
| ✅ Rich metadata | Receive titles, descriptions, uploader info. |
| ✅ Engagement data | Get view counts, like counts, and metrics. |
| ✅ Batch processing | Process multiple Reels efficiently. |
| ✅ High resolution | Get video resolution and quality info. |
| ✅ Residential proxies | Bypass restrictions – reliable access. |
| ✅ Error handling | Robust fallback mechanisms. |
| ✅ Apify ecosystem | Seamless integration with other Actors, triggers, and webhooks. |

### 📦 Changelog

- Initial release of Facebook Reels Scraper
- Comprehensive Facebook Reels data extraction
- Direct download link generation via
- Metadata extraction (titles, descriptions, uploaders)
- Engagement metrics (views, likes, comments)
- Video quality and resolution information
- Thumbnail extraction
- Batch processing for multiple Reels
- Residential proxy support for reliability
- Error handling with detailed error messages
- Summary statistics and reporting
- Automatic dataset integration
- Full Apify Actor integration

***

### 🧑‍💻 Support & Feedback

- **Issues & Ideas:** Open a ticket on the Apify Actor issue tracker
- **Documentation:** Visit Apify Docs for comprehensive platform guides
- **Community:** Join the Apify community forum for discussions and support
- **Bug Reports:** Submit detailed bug reports through the issue tracker
- **Feature Requests:** Suggest new features to improve the scraper

***

### 💰 Pricing

- **Free** for basic usage on Apify platform
- **Paid plans** available for higher limits and priority support
- **Proxy credits** consumed based on residential proxy usage

**Disclaimer:**
Facebook Reels Scraper is provided as-is for research and analysis purposes. Users are responsible for ensuring their usage complies with Facebook's policies and applicable laws.

***

### 🎉 Get Started Today

**Begin scraping Facebook Reels now!**

Use Facebook Reels Scraper for:

- 📊 Reels Analytics
- 🔍 Content Research
- 💡 Trend Analysis
- 📈 Performance Tracking
- 🎯 Competitor Analysis

**Perfect for:**

- Content Strategists
- Researchers
- Marketers
- Social Media Managers
- Analysts

***

**Last Updated:** February 2025\
**Status:** Active Development\
**Support:** 24/7 Customer Support Available\
**Platform:** Apify

***

### 📚 Related Tools

For comprehensive Facebook analysis and content research, explore our full suite of tools:

- Facebook Posts Scraper
- Facebook Hashtag Scraper
- Facebook Video Downloader
- Facebook Ads Library Scraper
- All-in-One Media Downloader

# Actor input Schema

## `urls` (type: `array`):

List of Facebook Reel URLs to scrape.

## `proxyConfiguration` (type: `object`):

Residential Proxy recommended for Facebook.

## Actor input object example

```json
{
  "urls": [
    "https://www.facebook.com/reels/123456789/"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {};

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

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("datapilot/facebook-reels-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call datapilot/facebook-reels-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datapilot/facebook-reels-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/31M79VO9ujnXJH6pu/builds/86i5o2vPZTh7xni8D/openapi.json