# Facebook Post Downloader (`codenest/facebook-post-downloader`) Actor

Get comprehensive Facebook post data including videos, photos & reels. Each post returns metadata (uploader, date, engagement), direct download URLs for multiple quality variants, separate audio tracks, thumbnails, and technical specs (codec, resolution, bitrate) in structured JSON format.

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

## Pricing

$15.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/actors/running/actors-in-store.md#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Post Downloader - Ultimate Social Media Content Saver

**Effortlessly download any Facebook content with our enterprise-grade powerful Facebook Post Downloader! This Apify actor enables you to batch download Facebook posts including videos, photos, and reels while preserving high quality, comprehensive metadata and direct CDN access.**

***

### 📋 Overview

Need to archive Facebook content or repurpose posts? This Facebook Post Downloader delivers:

- **Universal Download**: Videos, photos, reels, and text posts
- **Dual Format Access**: Separate video/audio tracks or merged files
- **Apify Storage**: Encrypted download URLs
- **Full Metadata**: Titles, authors, upload dates, engagement metrics
- **Proxy-ready**: Bypass geo/IP restrictions

Perfect for marketers 📈, content agencies 🎬, social media managers 📊, and app developers 📱!

### ⚡ Core Capabilities/Key Features

#### 📥 Media Options

- **Universal Support**: Download videos, photos, reels, and mixed-content posts
- **Dual Formats**: Video-only MP4 + separate M4A audio tracks
- **Merged Output**: Combined audio+video files for seamless playback
- **Photo Download**: High-resolution image extraction
- **Bulk Mode**: Process 100+ URLs per run with this Facebook Post Downloader

#### 📊 Metadata Mastery

- **Creator Profiles**: Author names/handles with profile URLs
- **Upload Dates**: YYYY-MM-DD timestamps with Unix time
- **Engagement Data**: View counts, like counts, comment counts
- **Post Type Detection**: Automatic identification (video/photo/reel/text)
- **Duration**: Precise video length in seconds

#### 🛡️ Advanced Tech

- **Proxy Groups**: Residential IP rotation for reliable access
- **Resolution Fallback**: Auto-select best available quality
- **Multiple Variants**: Access all available quality tiers
- **CDN Direct Links**: Fast, reliable downloads

***

### ⚙️ Input Configuration

Just enter the Facebook post URLs in the Input Section then click the "start" button and wait for the results. The Facebook Post Downloader accepts various URL formats including share links, watch URLs, and post permalinks.

```json
{
  "urls": [
    {
      "url": "https://www.facebook.com/share/v/1C1samDpkm/"
    },
    {
      "url": "https://www.facebook.com/share/p/172e7qj22s/"
    },
    {
      "url": "https://www.facebook.com/share/v/1Gkf8TA6hh/"
    }
  ]
}
```

#### 📝 Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urls` | Array | Yes | Array of Facebook post URLs to process |
| `url` | String | Yes | Valid Facebook post URL (share/ format, watch URLs, post permalinks) |

***

### 📤 Output Structure

You will see output like this from the Facebook Post Downloader,

```json
[
  {
    "input_url": "https://www.facebook.com/share/v/1C1samDpkm/",
    "post_type": "video",
    "title": "৮০% পর্যন্ত ছাড়!",
    "description": "Kids Toys -এ মেগা ডিসকাউন্ট ৮০% পর্যন্ত ছাড়!",
    "uploader": "Othoba.com",
    "uploader_id": "100064769374077",
    "uploader_url": "https://www.facebook.com/100064769374077",
    "upload_date": "20260131",
    "timestamp": 1769849683,
    "duration": 16,
    "view_count": 227569,
    "thumbnail_url": "https://scontent.../thumbnail.jpg",
    "reel_download_url": "https://video.../video.mp4",
    "audio_download_url": "https://video.../audio.m4a",
    "video_with_audio_variants": [
      {
        "url": "https://video.../sd.mp4",
        "format_id": "sd",
        "ext": "mp4"
      },
      {
        "url": "https://video.../hd.mp4",
        "format_id": "hd",
        "ext": "mp4"
      }
    ]
  }
]
```

#### 📚 Output Field Documentation

**📋 Metadata Section**
| Field | Description |
|-------|-------------|
| `input_url` | Original Facebook URL provided |
| `post_type` | Content type (video/photo/reel/text) |
| `title` | Post title or caption |
| `description` | Full post description/content |
| `uploader` | Content creator's Facebook name |
| `uploader_id` | Creator's numeric Facebook ID |
| `uploader_url` | Direct link to creator's profile |
| `upload_date` | Publication date in YYYYMMDD format |
| `timestamp` | Unix timestamp of upload |
| `duration` | Video length in seconds (decimal precision) |
| `view_count` | Total video views |
| `like_count` | Number of likes (for photos) |
| `comment_count` | Number of comments (for photos) |

**🎬 Media Assets**
| Field | Description |
|-------|-------------|
| `thumbnail_url` | High-quality preview image |
| `reel_download_url` | Primary video download URL |
| `audio_download_url` | Separate audio stream URL |
| `photo_download_url` | High-resolution photo download |
| `video_with_audio_variants` | Merged video+audio options |
| `video_variants` | Video-only quality options |
| `audio_variants` | Audio-only stream options |
| `thumbnails` | Multiple thumbnail variations |

**📊 Quality Options**
| Field | Description |
|-------|-------------|
| `format_id` | Unique identifier for each quality |
| `ext` | File extension (mp4, m4a, jpg) |
| `resolution` | Video dimensions (e.g., "720x720") |
| `height` | Vertical resolution in pixels |
| `width` | Horizontal resolution in pixels |
| `vcodec` | Video codec specification |
| `acodec` | Audio codec specification |
| `tbr` | Bitrate in kbps |
| `format_note` | Format description (DASH video/audio) |

***

### 📊 Quality Tiers Available

The Facebook Post Downloader automatically detects and provides multiple quality options:

1. **🎯 High Definition** - Up to 1080p with advanced codec support
2. **📱 Standard Definition** - 720p optimized for most devices
3. **📟 Mobile Optimized** - Lower resolutions for bandwidth conservation
4. **🎵 Audio Only** - Separate M4A tracks for music/sound extraction
5. **🖼️ High-Res Photos** - Original quality image downloads

Each quality tier includes technical specifications for professional editing workflows.

***

### 🔧 Technical Features

#### 🎚️ Advanced Format Support

- DASH video streaming format extraction
- Multiple codec support (AVC/H.264)
- Separate audio/video stream access
- Container format detection
- Facebook-specific URL handling

#### 📊 Metadata Extraction

- Precise duration timing (millisecond accuracy)
- Upload timestamp preservation
- Creator attribution with profile links
- Engagement metrics (views, likes, comments)
- Post type classification
- Multiple quality variant detection

#### 🛡️ Reliability Features

- Direct CDN access for maximum reliability
- Multiple quality fallback options
- Comprehensive error handling
- URL validation and normalization
- Support for share links, watch URLs, and permalinks
- Batch processing capability

***

### 🎯 Use Cases

- **📱 App Developers** – Build Facebook-powered apps with our Facebook Post Downloader
- **📊 Social Managers** – Archive client content and engagement metrics
- **🎵 Music Analysts** – Track audio trends and viral content
- **✂️ Editors** – Remix raw video/audio tracks for content creation
- **🔬 Researchers** – Study virality patterns and content performance
- **📈 Marketers** – Analyze competitor content and ad campaigns
- **🏢 Media Agencies** – Repurpose Facebook content across platforms
- **📚 Archivists** – Preserve important cultural and news content

***

### ✅ Why Choose Our Facebook Post Downloader?

- **🌟 Reliable Performance**: Stable and efficient downloading process
- **🔄 Universal Compatibility**: Works with all Facebook post types
- **🎯 User-Friendly**: Simple interface for both beginners and advanced users
- **🔄 Regular Updates**: Maintained to ensure compatibility with Facebook changes
- **📊 Comprehensive Data**: Get all the metadata you need in one place
- **🚀 Fast Processing**: Optimized for speed and efficiency
- **🔒 Secure**: Encrypted download links via Apify storage
- **💪 Scalable**: Batch process hundreds of URLs

***

### ⚠️ Limitations

- Only works with public Facebook posts and pages.
- The Facebook Post Downloader may hit rate limits depending on Facebook's restrictions.
- Private/restricted content cannot be accessed.
- Some geographic restrictions may apply based on content availability.

***

### 🔗 Related Actors (Full Social Media Scraping Suite)

Explore our complete scraping suite for enhanced social media content extraction:

#### 🎵 Facebook Scrapers:

- [Facebook Video Downloader](https://apify.com/codenest/facebook-video-downloader)
- [Facebook Reels Downloader](https://apify.com/codenest/facebook-reels-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 Downloader & Video Downloader](https://apify.com/codenest/facebook-reels-downloader-video-downloader)
- [Facebook Story Downloader](https://apify.com/codenest/facebook-story-downloader)

#### 📸 Instagram Scrapers:

- [Instagram Reels Downloader](https://apify.com/codenest/instagram-reels-downloader)
- [Instagram Video Downloader](https://apify.com/codenest/instagram-video-downloader)
- [Instagram Scraper (Reels & Video)](https://apify.com/codenest/instagram-scraper-reels-video)
- [Instagram Reels Scraper & Downloader](https://apify.com/codenest/instagram-reels-downloader-scraper)
- [Instagram Post Downloader (Image & Video)](https://apify.com/codenest/instagram-post-downloader-image-video)
- [Instagram Story Downloader](https://apify.com/codenest/instagram-story-downloader)
- [Instagram Story Scraper](https://apify.com/codenest/instagram-story-scraper)
- [Instagram Profile Scraper](https://apify.com/codenest/instagram-profile-scraper)

#### 🎥 YouTube Scrapers:

- [YouTube Video Downloader](https://apify.com/codenest/youtube-video-downloader)
- [YouTube Shorts Downloader](https://apify.com/codenest/youtube-shorts-downloader)
- [YouTube Shorts Scraper & Downloader](https://apify.com/codenest/youtube-shorts-scraper-downloader)
- [YouTube Shorts & Video Downloader](https://apify.com/codenest/youtube-shorts-video-downloader)
- [YouTube Thumbnail Scraper & Downloader](https://apify.com/codenest/youtube-thumbnail-scraper-downloader)
- [YouTube  Mp3/Audio Downloader](https://apify.com/codenest/youtube-mp3-audio-downloader)

#### 📱 TikTok Scrapers:

- [TikTok Video Scraper & Downloader](https://apify.com/codenest/tiktok-video-scraper-downloader)
- [TikTok Video Downloader](https://apify.com/codenest/tiktok-video-downloader)

#### 🐦 Twitter/X.com Specialized Actors:

- [Twitter (X.com) Video Post Scraper](https://apify.com/codenest/twitter-x-com-video-post-scraper)
- [Twitter (X.com) Image Downloader](https://apify.com/codenest/twitter-x-com-image-downloader)
- [Twitter(X.com) Tweets Scraper](https://apify.com/codenest/twitter-x-com-tweets-scraper)
- [Twitter (X.com) mp3/Audio Downloader](https://apify.com/codenest/twitter-x-com-mp3-audio-downloader)

#### 📱 Snapchat Scrapers:

- [Snapchat Story Scraper](https://apify.com/codenest/snapchat-story-scraper)
- [Snapchat Spotlight Scraper](https://apify.com/codenest/snapchat-spotlight-scraper)

#### Pinterest Scrapers:

- [Pinterest Video & Image Scraper](https://apify.com/codenest/pinterest-video-image-scraper)
- [Pinterest Video Scraper & Downloader](https://apify.com/codenest/pinterest-video-scraper-downloader)
- [Pinterest Image Scraper & Downloader](https://apify.com/codenest/pinterest-image-scraper-downloader)

#### Reddit Scrapers:

- [Reddit Video & Image Post Scraper](https://apify.com/codenest/reddit-video-image-post-scraper)

***

### 📧 Need Customization?

Want \*higher resolutions, \*\*batch downloads at scale, \*\*custom metadata fields, or \**enterprise solutions*?

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

***

# Actor input Schema

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

List of public Facebook post URLs. Accepts photos, videos, and reels in any combination.

## `cookie_header` (type: `string`):

Optional. Paste the raw Cookie header from your browser DevTools (Network tab → any facebook.com request → Headers → Cookie). This helps access login-gated content and improves success rate.

## Actor input object example

```json
{
  "urls": [
    {
      "url": "https://www.facebook.com/reel/1831270064408357"
    },
    {
      "url": "https://www.facebook.com/watch/?v=783325287492075"
    },
    {
      "url": "https://www.facebook.com/photo/?fbid=122101517096109874"
    }
  ]
}
```

# 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 = {
    "urls": [
        {
            "url": "https://www.facebook.com/reel/1831270064408357"
        },
        {
            "url": "https://www.facebook.com/watch/?v=783325287492075"
        },
        {
            "url": "https://www.facebook.com/photo/?fbid=122101517096109874"
        }
    ]
};

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

# Prepare the Actor input
run_input = { "urls": [
        { "url": "https://www.facebook.com/reel/1831270064408357" },
        { "url": "https://www.facebook.com/watch/?v=783325287492075" },
        { "url": "https://www.facebook.com/photo/?fbid=122101517096109874" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("codenest/facebook-post-downloader").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 '{
  "urls": [
    {
      "url": "https://www.facebook.com/reel/1831270064408357"
    },
    {
      "url": "https://www.facebook.com/watch/?v=783325287492075"
    },
    {
      "url": "https://www.facebook.com/photo/?fbid=122101517096109874"
    }
  ]
}' |
apify call codenest/facebook-post-downloader --silent --output-dataset

```

## MCP server setup

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

```

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/enjWJwwuwL3logi2z/builds/FmkI2HlhK4fHe4dMP/openapi.json