🎬 Facebook Video & Reel Scraper Actor

** It also work like e video downloader , cause it scrape also video url. you can download video form the output easily.**

📌 Actor Overview

This Apify Actor enables robust extraction of Facebook videos and reels metadata using yt-dlp. It is designed for both enterprise-grade automation and individual data collection, providing structured, clean, and normalized output for every video or reel processed.

• 🧩 Platform: Facebook
• ⚡ Content Type: Video & Reel
• 🛠️ Technology: Python, Apify SDK
• 🎯 Use Case: Social media analytics, content monitoring, competitor insights, marketing research

---

📌 What This Actor Does

This actor extracts detailed metadata from Facebook videos and reels provided via URLs. It normalizes and enhances the raw data for professional analysis.

• 🚀 Resolves URL redirects to access the final video/reel page
• 🎥 Detects whether a link is a video or reel
• 📊 Extracts views, likes, comments, reposts, captions, duration, upload date
• 🏷️ Parses hashtags and mentions from descriptions
• 🔗 Generates share URLs for Facebook, Twitter, LinkedIn
• 📦 Normalizes all data fields for consistent output across different content types

---

📌 Key Features

• 🌐 URL Resolution: Automatically follows redirects to reach the real content page
• 📽️ Video & Reel Detection: Intelligent classification to differentiate content types
• 🗂️ Normalized Output: Structured JSON with cleaned and formatted metadata
• ⏱️ Duration & Timestamp Formatting: Human-readable duration and ISO 8601 timestamps
• 👁️ View Count Normalization: Converts raw numbers into readable formats (e.g., 12.3K, 5.2M)
• 🔄 Fallback Records: Pushes error/fallback records if extraction fails, ensuring consistent dataset length
• 🖼️ Thumbnail & Resolution Info: Retrieves best video format with audio for optimal quality
• 🏷️ Hashtags & Mentions Extraction: Automatically parses content tags for further analysis
• ⚠️ Robust Error Handling: Catches and logs exceptions without halting execution

---

📌 How the Actor Works

1. 🔗 Input Handling: Accepts a list of Facebook URLs (startUrls)
2. 🕵️ URL Resolution: Resolves any redirect links to final destination
3. 🎯 Extraction: extract video/reel metadata
4. 🧹 Normalization:
   • Formats duration, upload date, view counts
   • Detects content type (video/reel)
   • Extracts hashtags, mentions, captions, and share URLs
5. 📝 Output: Pushes structured JSON for each video/reel
6. ⚡ Fallbacks: On failure, pushes fallback record to ensure dataset completeness

---

📌 Input Parameters

Parameter	Type	Description	Required	Default
startUrls	Array / String	List of Facebook video or reel URLs to scrape	✅	-
maxItems	Number	Maximum number of videos/reels to process	❌	0 (all)
proxyConfiguration	Object	Apify proxy configuration for accessing geo-restricted content	❌	-

Notes:

• startUrls can be a single URL or an array of objects { "url": "<url>" }.
• maxItems limits total processed videos; if 0, all URLs are processed.

---

---

Usage Examples

📌 input Example

{
    "startUrls": [
        {
            "url": "https://www.facebook.com/reel/1394880385139005",
            "method": "GET"
        },
        {
            "url": "https://www.facebook.com/share/r/1Cvc1uotQb/",
            "method": "GET"
        },
        {
            "url": "https://www.facebook.com/share/r/1CWWNzJ6Co/",
            "method": "GET"
        }
    ]
}

📌 Output Structure

Example JSON output for a single Facebook reel:

[
  {
    "platform": "facebook",
    "content_type": "video",
    "is_reel": false,
    "webpage_url": "https://m.facebook.com/watch/?v=1259352712869315&_rdr",
    "id": "1259352712869315",
    "title": "4.1K views · 51K reactions | Real💔🥀 #trending #relatable #explore more #fypppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppp | Algorithmo9",
    "description": "Real💔🥀\n\n#trending #relatable \n#explore more\n#fypppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppp",
    "duration_seconds": 9.384,
    "duration": "9s",
    "upload_date_raw": "20250811",
    "upload_date": "11-08-2025",
    "timestamp": 1754936813,
    "timestamp_iso": "2025-08-11T18:26:53Z",
    "view_count_raw": 616951,
    "view_count": "617.0K",
    "uploader": "Algorithmo9",
    "uploader_id": "61574644173798",
    "extractor": "facebook",
    "thumbnail": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.71878-10/530693202_1745060626143228_4309568590318795003_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=105&ccb=1-7&_nc_sid=50ce42&_nc_ohc=57mfWBvB2XAQ7kNvwFk-78T&_nc_oc=AdkPKGURUK2C6TlNMsi0X4XU8C3g8Wv94OVlLRonOsqcnGg9GbXb-P5tTudrLQ5ccgc&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=de3vacaHh16HKQsbxqN_gQ&oh=00_Afnas19s5ef42o4-0o3FoTikynkUnYDTI-GTG9__fs8bEw&oe=6946F8CA",
    "thumbnails": [
      {
        "url": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.71878-10/530693202_1745060626143228_4309568590318795003_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=105&ccb=1-7&_nc_sid=50ce42&_nc_ohc=57mfWBvB2XAQ7kNvwFk-78T&_nc_oc=AdkPKGURUK2C6TlNMsi0X4XU8C3g8Wv94OVlLRonOsqcnGg9GbXb-P5tTudrLQ5ccgc&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=de3vacaHh16HKQsbxqN_gQ&oh=00_Afnas19s5ef42o4-0o3FoTikynkUnYDTI-GTG9__fs8bEw&oe=6946F8CA",
        "id": "0"
      }
    ],
    "tags": [],
    "video_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m86/AQPxrnsMh58GgGhTlke8v75w16-chPbCOqWZgzDOd2OoeJF-nTe_DIFsYmsVwIZVC1jdo4t0RwuyFClHhsbSFdGh1w-lwNlFpu4xqlo.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=hw-ucvHDsIEQ7kNvwHez4_8&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6OTgzODMyNzEwNDU5NDA3LCJhc3NldF9hZ2VfZGF5cyI6MTI2LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6OSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=57c6f41bd8ae732e&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC82NDRDQzJERTJDMEIzMTdGRjMwOTIzRjM4RjE2OTc4Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HQzBmY2hfRWFQaEk3ZmtEQU1pem9uTzc0Vjh4YnFfRUFBQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmnsDN88yyvwMVAigCQzMsF0AiiDEm6XjVGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHUCZeadAQA&_nc_gid=de3vacaHh16HKQsbxqN_gQ&_nc_zt=28&oh=00_AfkBtyMYPEohcA9O48IJBf4vTuWOe8MQI6fTGUcuLatMsw&oe=694306C7&bitrate=420518&tag=dash_baseline_1_v1",
    "share_urls": {
      "facebook": "https://www.facebook.com/sharer/sharer.php?u=https://m.facebook.com/watch/?v=1259352712869315&_rdr",
      "twitter": "https://twitter.com/intent/tweet?url=https://m.facebook.com/watch/?v=1259352712869315&_rdr",
      "linkedin": "https://www.linkedin.com/sharing/share-offsite/?url=https://m.facebook.com/watch/?v=1259352712869315&_rdr"
    },
    "hashtags": [
      "trending",
      "relatable",
      "explore",
      "fypppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppp"
    ],
    "mentions": [],
    "privacy": "public",
    "resolution": "0x0",
    "width": 0,
    "height": 0,
    "captions": {},
    "page_category": "video.other",
    "content_category": [],
    "availability": ""
  },
  {
    "platform": "facebook",
    "content_type": "reel",
    "is_reel": true,
    "webpage_url": "https://m.facebook.com/watch/?v=1394880385139005&_rdr",
    "id": "1394880385139005",
    "title": "1M views · 10K reactions | Lagta he Aaj Shadi cancel Ho jayega 😢 ! . . . . . [Follow:- @_fitwithadi01_ ]for more gym related content Like. . . . #shadi #mummy #girlfriend #lovemarriage❤️ #fypppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppp #fypage # #foryou #fitwithadi01 #gym #gymnastics #gymaddict #gymrat #typage #fitness #fitnessmodel #asthetic #instagood #viral #explore #trendingsongs #viralreels #trending #viralvideos #viralaudio#fitnessmotivation #13august #14august #15august | Pl2w",
    "description": "Lagta he Aaj Shadi cancel Ho jayega 😢 !\n.\n.\n.\n.\n.\n [Follow:- @_fitwithadi01_ ]for more gym related content Like.\n.\n.\n.\n#shadi #mummy #girlfriend #lovemarriage❤️ #fypppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppp \n #fypage # #foryou #fitwithadi01 #gym\n#gymnastics #gymaddict #gymrat #typage #fitness #fitnessmodel #asthetic #instagood #viral #explore #trendingsongs #viralreels #trending #viralvideos\n#viralaudio#fitnessmotivation\n#13august #14august #15august",
    "duration_seconds": 14.425,
    "duration": "14s",
    "upload_date_raw": "20250813",
    "upload_date": "13-08-2025",
    "timestamp": 1755061455,
    "timestamp_iso": "2025-08-13T05:04:15Z",
    "view_count_raw": 792955,
    "view_count": "793.0K",
    "uploader": "Pl2w",
    "uploader_id": "61577364598587",
    "extractor": "facebook",
    "thumbnail": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.82787-10/533084073_17860519461462291_2999992689737121278_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=105&ccb=1-7&_nc_sid=50ce42&_nc_ohc=fDawpBW4qAYQ7kNvwFOsCO-&_nc_oc=AdnYo8shhyoPpseARJFZNHbILs-WU2GcOMgIm_xECx2q3tMegMYlw2IZCnmqkSFVA0Y&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=AzrRhgLBMMMGNTV3zVEbCw&oh=00_AflT9SGSlU8AoTV6hn46-03_qnxzGwz4An630LyTXeK8AQ&oe=69470CC0",
    "thumbnails": [
      {
        "url": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.82787-10/533084073_17860519461462291_2999992689737121278_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=105&ccb=1-7&_nc_sid=50ce42&_nc_ohc=fDawpBW4qAYQ7kNvwFOsCO-&_nc_oc=AdnYo8shhyoPpseARJFZNHbILs-WU2GcOMgIm_xECx2q3tMegMYlw2IZCnmqkSFVA0Y&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=AzrRhgLBMMMGNTV3zVEbCw&oh=00_AflT9SGSlU8AoTV6hn46-03_qnxzGwz4An630LyTXeK8AQ&oe=69470CC0",
        "id": "0"
      }
    ],
    "tags": [],
    "video_url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m86/AQMzfxlrrUqyJIo8QTq3-2Yp2kM-4Ty6Hgd1H157WKkzVisNrw_S_8tEIR72zd493A0jUGjqyamD0RMsd_DT-0qlbFFe70GKvzDoRxE.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=0nDb-46nfC0Q7kNvwGK07nV&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTMyNDY3NTMxMjUxMDMwMywiYXNzZXRfYWdlX2RheXMiOjEyNSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=72e0b40ce5359375&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9DRTQ2MDgyRTE2RDRDMTc4QTNEMkQwQUJEREQ5NkFBNF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HQlh0dHgtdmNLOWN6aTBDQUQ5VlhfbnZUc1owYnFfRUFBQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmvpWPl6Cy2gQVAigCQzMsF0As3bItDlYEGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHUCZeadAQA&_nc_gid=AzrRhgLBMMMGNTV3zVEbCw&_nc_zt=28&oh=00_Afm6RLyMcAJM6ZK4nAW3RTk8mAs2xYCCzmeVMAF9KXuv5A&oe=6943142D&bitrate=1281094&tag=dash_baseline_1_v1",
    "share_urls": {
      "facebook": "https://www.facebook.com/sharer/sharer.php?u=https://m.facebook.com/watch/?v=1394880385139005&_rdr",
      "twitter": "https://twitter.com/intent/tweet?url=https://m.facebook.com/watch/?v=1394880385139005&_rdr",
      "linkedin": "https://www.linkedin.com/sharing/share-offsite/?url=https://m.facebook.com/watch/?v=1394880385139005&_rdr"
    },
    "hashtags": [
      "shadi",
      "mummy",
      "girlfriend",
      "lovemarriage",
      "fypppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppppp",
      "fypage",
      "foryou",
      "fitwithadi01",
      "gym",
      "gymnastics",
      "gymaddict",
      "gymrat",
      "typage",
      "fitness",
      "fitnessmodel",
      "asthetic",
      "instagood",
      "viral",
      "explore",
      "trendingsongs",
      "viralreels",
      "trending",
      "viralvideos",
      "viralaudio",
      "fitnessmotivation",
      "13august",
      "14august",
      "15august"
    ],
    "mentions": [
      "_fitwithadi01_"
    ],
    "privacy": "public",
    "resolution": "0x0",
    "width": 0,
    "height": 0,
    "captions": {},
    "page_category": "video.other",
    "content_category": [],
    "availability": ""
  },
  {
    "platform": "facebook",
    "content_type": "video",
    "is_reel": false,
    "webpage_url": "https://m.facebook.com/watch/?v=1741183620609782&_rdr",
    "id": "1741183620609782",
    "title": "1.9M views · 72K reactions | POV: Riding In Dhaka | #ar7even #hondansx #rangeroversportsvr #bmwz4 #lc250 #gls600 #BMWX7 #nsx #porschecayenne #carsofbangladesh #carsinbangladesh #dhakacity #dhakagram #Bangladesh | AR7even.",
    "description": "POV: Riding In Dhaka | #ar7even #hondansx #rangeroversportsvr #bmwz4 #lc250 #gls600 #BMWX7 #nsx #porschecayenne #carsofbangladesh #carsinbangladesh #dhakacity #dhakagram #Bangladesh",
    "duration_seconds": 16.216,
    "duration": "16s",
    "upload_date_raw": "20250710",
    "upload_date": "10-07-2025",
    "timestamp": 1752170274,
    "timestamp_iso": "2025-07-10T17:57:54Z",
    "view_count_raw": 1042047,
    "view_count": "1.0M",
    "uploader": "AR7even.",
    "uploader_id": "61571536370787",
    "extractor": "facebook",
    "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/518785338_730092796670898_8878360506413717621_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=tA_Na10Hqz8Q7kNvwEG-RQE&_nc_oc=Adnzw7gowNfkwANJK7Af1NBQIHCZmR6_kyR_lbu8xofPnvHxu37hIeGi0pgEDedoH6c&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=QksXUZP5ul5vCAPAgnGyLA&oh=00_AflOv_UqH4G5iu15PXRoliNGU0R4FTH3Tym2ix1cVM6eFQ&oe=6946FEF7",
    "thumbnails": [
      {
        "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/518785338_730092796670898_8878360506413717621_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=tA_Na10Hqz8Q7kNvwEG-RQE&_nc_oc=Adnzw7gowNfkwANJK7Af1NBQIHCZmR6_kyR_lbu8xofPnvHxu37hIeGi0pgEDedoH6c&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=QksXUZP5ul5vCAPAgnGyLA&oh=00_AflOv_UqH4G5iu15PXRoliNGU0R4FTH3Tym2ix1cVM6eFQ&oe=6946FEF7",
        "id": "0"
      }
    ],
    "tags": [],
    "video_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQM80xJlZX68_yDiVBby5eMg6Sxlz3vIORtZzVWsyMO_Yb3NQtzFBKrsxW8dak-D44OMby_zWYQJ9Z3gFAxWuzgh7NY50NpZd_Tt2R_9ZWWUdQ.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=ll1VnOLrHUYQ7kNvwEhsO8z&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjE3MDczNzEzNzY4MTExNDEsImFzc2V0X2FnZV9kYXlzIjoxNTgsInZpX3VzZWNhc2VfaWQiOjEwMTIwLCJkdXJhdGlvbl9zIjoxNiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=48d0ed946c3a43c&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC9GOTQxMEE0MzJDQjc0Qjk4MTQ2RDBCRDZDNURENzZBNF9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0Q3NDRBRTFDOEI1MDE3MTJENjdBREE0OEJCNTc0MjgwX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaK8tCGjLaIBhUCKAJDMywXQDA7peNT988YGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZCeAQA&_nc_gid=QksXUZP5ul5vCAPAgnGyLA&_nc_zt=28&oh=00_Afl4wV_3Bk32SAOPpEcL-gpaLIBvPj0Vq_tbZsIcjzc2UQ&oe=69470E35&bitrate=2617328&tag=dash_h264-basic-gen2_720p",
    "share_urls": {
      "facebook": "https://www.facebook.com/sharer/sharer.php?u=https://m.facebook.com/watch/?v=1741183620609782&_rdr",
      "twitter": "https://twitter.com/intent/tweet?url=https://m.facebook.com/watch/?v=1741183620609782&_rdr",
      "linkedin": "https://www.linkedin.com/sharing/share-offsite/?url=https://m.facebook.com/watch/?v=1741183620609782&_rdr"
    },
    "hashtags": [
      "ar7even",
      "hondansx",
      "rangeroversportsvr",
      "bmwz4",
      "lc250",
      "gls600",
      "BMWX7",
      "nsx",
      "porschecayenne",
      "carsofbangladesh",
      "carsinbangladesh",
      "dhakacity",
      "dhakagram",
      "Bangladesh"
    ],
    "mentions": [],
    "privacy": "public",
    "resolution": "0x0",
    "width": 0,
    "height": 0,
    "captions": {},
    "page_category": "video.other",
    "content_category": [],
    "availability": ""
  }
  
]

---

📌 Apify Platform Usage Guide

• 🟢 Input JSON: Define startUrls and optional maxItems
• 🟢 Dataset Output: Each processed video/reel is pushed to the default dataset
• 🟢 Key-Value Store: All results consolidated in ALL_RESULTS key
• 🟢 Logging: Actor logs detailed info, warnings, and errors for monitoring

---

📌 Performance & Limits

• ⚡ Max Concurrency: Sequential URL processing; maxItems controls total extraction
• 🌐 Network Timeout: 30 seconds per URL, configurable in main.py
• 🕒 Execution Time: Dependent on number of URLs and video lengths

---

📌 Error Handling & Edge Cases

• 🚫 Extraction Failures: Push fallback JSON record with scrape_success: false
• 🔄 Retry Logic: Network failures and errors do not halt execution
• ⚠️ Unsupported URLs: URLs not recognized as video/reel are logged and included as fallback
• 🛡️ Proxy Errors: Actor respects and logs inaccessible content

---

📌 Best Practices

• 📌 Always provide fully-qualified Facebook URLs
• 📌 Use Apify Proxy for georestricted content
• 📌 Set maxItems to limit resource usage
• 📌 Monitor logs for fallback records to ensure scraping completeness

---

📌 Common Use Cases

• 📈 Social media marketing analytics
• 🔍 Competitor content monitoring
• 📝 Archiving reels/videos for research
• 🧠 AI/ML model training datasets

---

📌 Notes & Warnings

• ⚠️ Only public videos and reels are accessible
• ⚠️ Actor does not download video files, only metadata
• ⚠️ Content behind authentication will fail without proper proxy/session setup
• ⚠️ Facebook may rate-limit or block requests if used aggressively

---

📌 Legal & Compliance Disclaimer

• ⚖️ Ensure compliance with Facebook's Terms of Service
• ⚖️ Do not use data for unauthorized commercial purposes
• ⚖️ Users are responsible for legal and ethical use of scraped data

---