# Facebook Video Post Scraper (`codenest/facebook-video-post-scraper`) Actor

(Cheapest Rate) Easily & safely extract Facebook video posts with metadata, audio URLs, and thumbnails! Perfect for marketers 📈, researchers 🔍, and developers 📱 analysing video content performance and engagement metrics. 🎆Facebook Video Post Scraper🎆.

- **URL**: https://apify.com/codenest/facebook-video-post-scraper.md
- **Developed by:** [CodeNest](https://apify.com/codenest) (community)
- **Categories:** Social media, Videos, Automation
- **Stats:** 31 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 facebook video scrapeds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Video Post Scraper - Professional Video Content Extraction Tool 🎬

**Effortlessly download and scrape Facebook video posts with our enterprise-grade Facebook Video Post Scraper! This powerful Apify actor enables you to extract comprehensive metadata, and direct CDN access from Facebook video posts.**

***

### 📊 Overview

Need to archive Facebook video content or analyze video performance? Our **Facebook Video Post Scraper** delivers:

- **Audio extraction**: Separate audio tracks available
- **Full metadata**: Titles, descriptions, view counts, upload dates
- **Proxy-ready**: Bypass geo/IP restrictions seamlessly

Perfect for social media managers 📈, content analysts 📊, and digital marketers 🎯!

### 🚀 Core Capabilities/Key Features

#### 🎥 Media Options

- **Multiple Formats**: separate M4A audio tracks
- **High-Quality Thumbnails**: Multiple preview images
- **Bulk Processing**: Handle multiple Facebook video URLs per run
- **Direct CDN Links**: Fast, reliable download URLs

#### 📋 Metadata Mastery

- **Creator Information**: Uploader names and IDs
- **Engagement Metrics**: View counts and timestamps
- **Content Details**: Titles, descriptions, durations
- **Timeline Data**: Precise upload dates and timestamps

#### ⚡ Advanced Tech

- **Proxy Support**: Residential IP rotation capabilities
- **Quality Variants**: Multiple audio format options
- **Comprehensive Extraction**: Full video post data capture

***

### ⚙️ Input Configuration

Just enter the Facebook video post URLs in the Input Section then click the "start" button and wait for the results. Configure your **Facebook Video Post Scraper** like this:

```json
{
  "post_urls": [
    {
      "url": "https://web.facebook.com/watch/?v=783325287492075",
      "method": "GET"
    }
  ]
}
```

#### 📋 Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_urls` | Array | Yes | Facebook video post URLs to process |
| `url` | String | Yes | Valid Facebook video post URL |
| `method` | String | Yes | HTTP method (GET recommended) |

***

### 📄 Output Structure

Your **Facebook Video Post Scraper** will generate comprehensive output like this:

```json
[
  {
    "url": "https://www.facebook.com/watch/?v=783325287492075",
    "title": "Fallout – Season Two Teaser Trailer | Prime Video India",
    "audio_download_url": "https://video-lga3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQPd0dM3jFV-5yAp6leVfTA5mEtM7xEL8Saon4i2r3SGxFTGz3mFr6gjXxia6bLhHir095IjBf2rj_vUcazFac3yC5TY-bOCQtPA4GE.mp4",
    "thumbnail_url": "https://scontent-lga3-2.xx.fbcdn.net/v/t15.5256-10/536625016_1422113702239824_8997957425835878271_n.jpg",
    "audio_variants": [
      {
        "url": "https://video-lga3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQPd0dM3jFV-5yAp6leVfTA5mEtM7xEL8Saon4i2r3SGxFTGz3mFr6gjXxia6bLhHir095IjBf2rj_vUcazFac3yC5TY-bOCQtPA4GE.mp4",
        "format_id": "1868705227403183a",
        "ext": "m4a",
        "acodec": "mp4a.40.5",
        "tbr": 68.052,
        "protocol": "https",
        "note": "DASH audio",
        "cdn_pref": 3
      }
    ],
    "thumbnails": [
      {
        "url": "https://scontent-lga3-2.xx.fbcdn.net/v/t15.5256-10/536625016_1422113702239824_8997957425835878271_n.jpg"
      }
    ],
    "id": "783325287492075",
    "webpage_url": "https://www.facebook.com/watch/?v=783325287492075",
    "uploader": "Prime Video",
    "uploader_id": "100064402071048",
    "duration": 162.162,
    "timestamp": 1755629418,
    "upload_date": "20250819",
    "view_count": 7687,
    "description": "The end of the world ain't over yet. Fallout Season Two arrives December 17.",
    "extractor": "facebook",
    "extractor_key": "Facebook"
  }
]
```

#### 📊 Output Field Documentation

**📋 Content Metadata**
| Field | Description |
|-------|-------------|
| `title` | Video post title or caption |
| `description` | Full video description text |
| `uploader` | Page or profile name that uploaded the video |
| `uploader_id` | Unique identifier of the uploader |
| `view_count` | Number of views on the video |

**⏰ Timeline Data**
| Field | Description |
|-------|-------------|
| `upload_date` | Publication date in YYYYMMDD format |
| `timestamp` | Unix timestamp of upload |
| `duration` | Video length in seconds (decimal precision) |

**🎬 Media Assets**
| Field | Description |
|-------|-------------|
| `audio_download_url` | Primary audio download URL |
| `thumbnail_url` | Main thumbnail image URL |
| `thumbnails` | Array of available thumbnail images |
| `webpage_url` | Original Facebook watch page URL |

**🎵 Audio Quality Options**
| Field | Description |
|-------|-------------|
| `format_id` | Unique identifier for audio format |
| `ext` | Audio file extension |
| `acodec` | Audio codec specification |
| `tbr` | Average audio bitrate |
| `note` | Format description |

***

### 🏆 Quality Features

The **Facebook Video Post Scraper** provides professional-grade extraction:

#### 🔧 Technical Excellence

- **DASH audio streaming** format extraction
- **Multiple codec support** for audio tracks
- **High-quality thumbnail** access
- **Comprehensive metadata** preservation

#### 📈 Data Accuracy

- **Precise duration timing** with millisecond accuracy
- **Exact upload timestamps** for content tracking
- **Real view counts** for performance analysis
- **Complete creator attribution** data

#### 🛡️ Reliability Features

- **Direct CDN access** for maximum reliability
- **Multiple thumbnail variants** availability
- **Comprehensive error handling**
- **URL validation** and normalization

***

### 💼 Use Cases

- **Content Archivists** – Preserve Facebook video content
- **Social Media Analysts** – Track video performance metrics
- **Marketing Agencies** – Analyze competitor video strategies
- **Researchers** – Study video engagement patterns
- **App Developers** – Build video-powered applications

***

#### 🌟 Why Choose Our Facebook Video Post Scraper?

- **Reliable Performance**: Stable and efficient scraping process
- **Comprehensive Data**: Get all video metadata in one place
- **User-Friendly**: Simple interface for beginners and professionals
- **Regular Updates**: Maintained for Facebook compatibility
- **Professional Grade**: Enterprise-level data extraction capabilities

***

#### ⚠️ Limitations

- Only works with public Facebook video posts
- The **Facebook Video Post Scraper** may encounter rate limits based on Facebook's restrictions
- Video availability depends on regional and privacy settings

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

Explore our full scraping suite for comprehensive social media data extraction:

#### 📱 Facebook Specialized:

- [Facebook Video Transcript Scraper](https://apify.com/codenest/facebook-video-transcript-scraper)
- [Facebook Video Downloader](https://apify.com/codenest/facebook-video-downloader)
- [Facebook Reels Audio Downloader](https://apify.com/codenest/facebook-reels-audio-downloader)
- [Facebook Thumbnail Downloader](https://apify.com/codenest/facebook-thumbnail-downloader)
- [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)
- [Facebook Reels Downloader](https://apify.com/codenest/facebook-reels-downloader)
- [Facebook Audio Downloader](https://apify.com/codenest/facebook-audio-downloader)
- [Facebook Reels Scraper](https://apify.com/codenest/facebook-reels-scraper)
- [Instagram Post Downloader (Image & Video)](https://apify.com/codenest/instagram-post-downloader-image-video)

***

### 📧 Need Customization?

Want \*enhanced metadata, \*\*batch processing improvements, or \**additional platform support* for your **Facebook Video Post Scraper**?

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

***

# Actor input Schema

## `post_urls` (type: `array`):

List of public Facebook video post URLs.

## Actor input object example

```json
{
  "post_urls": [
    {
      "url": "https://web.facebook.com/watch/?v=783325287492075"
    },
    {
      "url": "https://web.facebook.com/watch/?v=1374855850246642"
    }
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

All extracted Facebook video post download links, engagement counts, and metadata stored in the default dataset.

# 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 = {
    "post_urls": [
        {
            "url": "https://web.facebook.com/watch/?v=783325287492075"
        },
        {
            "url": "https://web.facebook.com/watch/?v=1374855850246642"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("codenest/facebook-video-post-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 = { "post_urls": [
        { "url": "https://web.facebook.com/watch/?v=783325287492075" },
        { "url": "https://web.facebook.com/watch/?v=1374855850246642" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("codenest/facebook-video-post-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 '{
  "post_urls": [
    {
      "url": "https://web.facebook.com/watch/?v=783325287492075"
    },
    {
      "url": "https://web.facebook.com/watch/?v=1374855850246642"
    }
  ]
}' |
apify call codenest/facebook-video-post-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,codenest/facebook-video-post-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/MzeIIej3uKgkvNVzH/builds/uPOXxWCUj5qrcAxLp/openapi.json
