Facebook Reels Scraper

🚀 Facebook Posts & Reels Scraper (Direct URLs, Pages & Hashtags)

The all-in-one, dual-engine Facebook scraper for Apify. Scrape direct post URLs (photos, multi-image albums, videos, reels, metrics, and comments) or extract bulk Reels from Facebook Pages, Profiles, and Hashtags with direct HD video download links and creator attribution.

---

🌟 Why Choose This Scraper?

• ⚡ Dual-Engine Flexibility:
  • Mode 1 (Direct Post URLs): Lightning-fast TLS fingerprint bypass (curl_cffi + yt-dlp) to scrape public Facebook posts, photo albums, videos, and reels with full engagement metrics and recent comments.
  • Mode 2 (Page & Hashtag Reels): Automated Playwright browser engine to scroll and collect bulk Reels from any Facebook Page, Creator profile, or Hashtag feed (e.g. #comedy, #sports, #wildlife).
• 🎬 Direct HD Media Downloads: Extracts original high-resolution MP4 video URLs (CDN) and full-size JPG/PNG photo URLs.
• 👤 Creator & Uploader Attribution: Automatically identifies the creator/channel (uploader, uploader_id, uploader_url) for every single Reel—especially crucial for hashtag feeds where each video comes from a different creator.
• ✨ Clean, Pristine Captions: Automatically strips raw HTML entity garbage (e.g., ·, 😂), removes messy view/reaction prefixes, and extracts authentic hashtags without fake artifacts.
• 📊 Numeric & Formatted Metrics: Provides both human-readable ("1.3M", "45K") and clean integer metrics (views_count, likes_count, comments_count, shares_count) for instant filtering in Excel, CSV, Google Sheets, or BI tools.
• 🛡️ Anti-Ban & Proxy Ready: Built-in support for Apify Residential Proxies with smart session handling to bypass Facebook login walls and rate limits.

---

🎯 Supported Scraping Modes

1️⃣ Mode 1: Direct Post URLs

Pass a list of specific Facebook links under urls:

• Photos & Single Images (e.g. https://www.facebook.com/share/p/...)
• Multi-Photo Albums & Carousels
• Watch Videos (e.g. https://www.facebook.com/watch/?v=...)
• Direct Reels (e.g. https://www.facebook.com/reel/...)
• Optional Recent Comments Extraction with authors and timestamps.

2️⃣ Mode 2: Bulk Reels from Pages & Profiles

Pass one or more Facebook Page or Creator profile URLs under pageUrls:

• Automatically navigates to the Page's Reels timeline.
• Smoothly scrolls to collect up to your specified maxPosts limit.
• Fallback enrichment extracts 100% accurate GraphQL feedback data, HD MP4 links, durations, and creator details.

3️⃣ Mode 3: Bulk Reels from Hashtags

Pass hashtag names under hashtags (e.g. ["comedy", "wildlife", "travel"]) or full URLs:

• Searches and scrolls through the hashtag feed.
• Discovers trending community Reels across hundreds of independent creators.
• Captures each creator's unique name, profile ID, and video link.

---

⚙️ Input Parameters

Parameter	Type	Required	Default	Description
urls	Array of Objects	❌ Optional	[]	Mode 1: Direct Facebook post, photo, video, or reel URLs.
pageUrls	Array of Strings	❌ Optional	[]	Mode 2: Facebook Page or Profile URLs to scrape bulk reels from.
hashtags	Array of Strings	❌ Optional	[]	Mode 2: Facebook hashtags to scrape (e.g. ["comedy", "news"]).
maxPosts	Integer	❌ Optional	50	Maximum number of reels to collect per page/hashtag (5 to 1000).
include_comments	Boolean	❌ Optional	false	Enable to extract recent comments for direct posts (Mode 1).
max_comments	Integer	❌ Optional	25	Maximum recent comments to extract per post.
flattenOutput	Boolean	❌ Optional	false	Flatten output into single rows for clean Excel / CSV export.
maxConcurrency	Integer	❌ Optional	10	Parallel concurrent workers for high-speed metadata enrichment.
headless	Boolean	❌ Optional	true	Run browser in headless mode.
proxy	Object	❌ Optional	RESIDENTIAL	Apify Proxy configuration (Residential proxy recommended).
cookie_header	String	❌ Optional	""	Optional Facebook session cookies (c_user=...; xs=...) for restricted content.

---

📝 Input Examples

Example A: Scraping Facebook Pages & Hashtags (Bulk Reels)

{
  "pageUrls": [
    "https://www.facebook.com/MundoAnimalHistorias"
  ],
  "hashtags": [
    "comedy"
  ],
  "maxPosts": 50,
  "flattenOutput": true,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Example B: Scraping Direct Post URLs (Photos, Reels, Videos)

{
  "urls": [
    { "url": "https://web.facebook.com/share/p/1DVg2qCC9Y/" },
    { "url": "https://www.facebook.com/reel/2605277543319794/" }
  ],
  "include_comments": true,
  "max_comments": 20
}

---

📤 Output Format

The actor delivers clean, standardized JSON objects directly to the Apify dataset:

Sample Reel Output (Mode 2 — Page & Hashtag)

{
  "target": "https://www.facebook.com/hashtag/comedy",
  "target_title": "#comedy",
  "post_number": 1,
  "post_url": "https://www.facebook.com/reel/2139373990037087/",
  "post_id": "2139373990037087",
  "post_type": "video",
  "uploader": "Paola Ruíz",
  "uploader_id": "100044567891234",
  "uploader_url": "https://www.facebook.com/100044567891234",
  "caption": "ESPERA EL DISFRAZ ‼️😂 Jamás creí ponerme esto ….\n•\n• #comedy #humor #halloween",
  "description": "ESPERA EL DISFRAZ ‼️😂 Jamás creí ponerme esto ….\n•\n• #comedy #humor #halloween",
  "creation_time": "27 October 2026 at 22:02",
  "timestamp": 1793138554,
  "downloadable_url": "https://video.fbtr1-1.fna.fbcdn.net/o1/v/t2/f2/m367/...mp4",
  "duration_seconds": 8.57,
  "thumbnail_url": "https://scontent.fbtr1-1.fna.fbcdn.net/v/...jpg",
  "hashtags": [
    "#comedy",
    "#humor",
    "#halloween"
  ],
  "likes": "1M",
  "likes_count": 1021309,
  "comments": "7294",
  "comments_count": 7294,
  "shares": "46K",
  "shares_count": 46000,
  "views": "6M",
  "views_count": 6000000,
  "mentions": [],
  "recent_comments": []
}

Sample Direct Post Output (Mode 1 — Photos & Albums)

{
  "url": "https://www.facebook.com/100075450447536/posts/1130794772778860/",
  "input_url": "https://web.facebook.com/share/p/1DVg2qCC9Y/",
  "post_id": "1130794772778860",
  "title": "# Hrithik Roshan's Family ❤️",
  "caption": "# Hrithik Roshan's Family ❤️\n\nHrithik Roshan is one of Bollywood's most admired actors...",
  "description": "# Hrithik Roshan's Family ❤️\n\nHrithik Roshan is one of Bollywood's most admired actors...",
  "post_type": "photo",
  "uploader": "ताजा खबर ऑनलाइन",
  "uploader_id": "100075450447536",
  "uploader_url": "https://www.facebook.com/100075450447536",
  "post_date": "2026-11-02 15:34:40 UTC",
  "likes": 9500,
  "like_count": "9.5K",
  "shares_count": 66,
  "images_count": 1,
  "photo_download_url": "https://scontent-ord5-1.xx.fbcdn.net/v/...jpg",
  "thumbnail_url": "https://scontent-ord5-1.xx.fbcdn.net/v/...jpg",
  "hashtags": []
}

---

📋 Complete Field Reference

Field	Type	Description
uploader	String	Creator / Page name that uploaded the post/reel.
uploader_id	String	Unique numeric Facebook ID of the uploader (when available).
uploader_url	String	Direct Facebook profile or page link of the creator.
post_url / url	String	Canonical link to the Facebook post or reel.
post_id	String	Facebook numeric content identifier.
post_type	String	Content category: video, photo, album, or reel.
caption	String	Full post caption with HTML entities decoded and metrics stripped.
description	String	Full description text matching caption.
downloadable_url	String	Direct CDN URL to download the high-resolution MP4 or JPG file.
thumbnail_url	String	High-resolution thumbnail image URL.
duration_seconds	Float	Video duration in seconds (e.g. 18.33).
creation_time	String	Formatted publication date (e.g. 02 November 2026 at 20:55).
timestamp	Integer	Unix epoch timestamp of when the content was published.
views	String	Formatted view count (e.g. "175K", "1.3M").
views_count	Integer	Numeric view count integer (e.g. 175000).
likes	String / Int	Formatted like/reaction count (e.g. "4.5K").
likes_count	Integer	Numeric like count integer (e.g. 4526).
comments_count	Integer	Total comment count integer.
shares_count	Integer	Total share count integer.
hashtags	Array	Clean hashtags list (e.g. ["#comedy", "#viral"]).
recent_comments	Array	Structured list of recent comments (author, text, time).

---

💡 Performance & Memory Best Practices

• Recommended Memory: 2048 MB (Default). This ensures smooth Playwright browser execution without out-of-memory risks while minimizing Apify CU consumption.
• Proxies: Facebook aggressively rate-limits datacenter IPs. Using Apify Residential Proxies (RESIDENTIAL) guarantees 99.9% extraction success.
• Concurrency: The default concurrency is set to 10. For large runs (500+ posts), keep concurrency between 5 and 15 to maintain optimal throughput.

---

❓ Frequently Asked Questions

Q: Do I need a Facebook account or cookies to use this?
A: No! Public posts, public pages, public hashtag feeds, and reels can be scraped completely anonymously without logging in. Session cookies are only required if you need to scrape age-restricted or country-locked content.

Q: Can I download the videos directly from the dataset?
A: Yes! Every video and reel record contains downloadable_url, pointing directly to the Facebook CDN progressive MP4 stream. You can download it directly using any HTTP client or browser.

Q: How do I export data to Excel or Google Sheets?
A: Set "flattenOutput": true. In the Apify Console Dataset tab, click Export and choose CSV or Excel.

---

📧 Support & Custom Features

Need custom scrapers, dedicated enterprise proxies, or specific field extractions?
Contact: codenest2.0@gmail.com