🎥 Facebook Video Scraper — Apify Actor ** It also work like e video downloader , cause it scrape also video url. you can download video form the output easily. --- ## 📌 Actor Overview 🚀 Facebook Video Scraper is a production-grade Apify Actor designed to extract rich, structured metadata from Facebook video URLs with high reliability and enterprise-ready robustness. ⚙️ Built on Apify Python SDK and powered by yt-dlp, this actor automatically handles retries, proxy fallback, data normalization, and structured output delivery — making it ideal for analytics, monitoring, research, and automation workflows. --- ## 🎯 What This Actor Does 🔍 This actor accepts one or more Facebook video URLs and extracts detailed metadata without downloading the video files. 📦 Extracted data is: - ✅ Pushed to the default Apify dataset - ✅ Stored in the Apify Key-Value Store under OUTPUT - ✅ Normalized, cleaned, and null-safe - ✅ Ready for downstream pipelines, dashboards, or APIs --- ## ✨ Key Features - 🧠 Smart Metadata Extraction via yt-dlp - 🌐 Automatic Proxy Fallback using Apify Residential Proxy - 🔁 Retry Logic with graceful degradation - 🧹 Null & Empty Field Pruning - 🧾 Rich Content Metadata (hashtags, mentions, captions, stats) - 📊 Human-Readable Metrics (views, duration, resolution) - 🔐 No Login Required - ⚡ Fast & Lightweight Execution - ☁️ Fully Apify Marketplace Ready --- ## 🔄 How the Actor Works (Step-by-Step) 1. 🧾 Input Parsing - Reads startUrls from actor input - Supports multiple Facebook video URL formats 2. 🔍 Primary Extraction Attempt - Extracts metadata directly using yt-dlp - No proxy used initially for speed 3. 🔁 Automatic Retry with Proxy - On failure, initializes Apify Residential Proxy - Retries extraction using proxy routing 4. 🧠 Data Normalization - Formats timestamps, durations, resolutions - Extracts hashtags & mentions from descriptions - Generates social share URLs 5. 🧹 Data Cleanup - Removes null, empty, and redundant fields - Ensures compact and clean JSON output 6. 📤 Output Delivery - Pushes each record to Apify Dataset - Stores full result array in Key-Value Store (OUTPUT) --- ## 🧪 Usage Examples ### ▶️ Example input: json { "startUrls": [ { "url": "https://www.facebook.com/share/v/17HheBqH1M/", "method": "GET" }, { "url": "https://www.facebook.com/watch?v=1028061379391984", "method": "GET" }, { "url": "https://www.facebook.com/watch?v=24830791633264689", "method": "GET" }, { "url": "https://www.facebook.com/ArohiIslam8/videos/1028061379391984/", "method": "GET" } ] } --- ## 📤 Output Structure (JSON Example) keep startUrls prefill items json [ { "id": "1378841030316664", "title": "379K views · 9K reactions | Hello Everyone 😍 Follow If You like😇 #venom #arabic #funnyvideos #management #managementconsulting | VENOM OP", "upload_date": "2025-10-13", "description": "Hello Everyone 😍 Follow If You like😇\n #venom #arabic #funnyvideos #management #managementconsulting", "view_count": "272.6k", "concurrent_view_count": "0", "uploader": "VENOM OP", "uploader_id": "100076371871709", "platform": "facebook", "extractor": "facebook", "extractor_key": "Facebook", "webpage_url": "https://m.facebook.com/watch/?v=1378841030316664&_rdr", "webpage_url_basename": "watch", "original_url": "https://www.facebook.com/share/v/17HheBqH1M/", "timestamp": "2025-10-13", "timestamp_iso": "2025-10-13T10:43:33Z", "duration": "1m 47s", "thumbnail": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/563463663_701381875690898_6935019733953855836_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=50ce42&_nc_ohc=eWMwUxL2MgIQ7kNvwF7WgGw&_nc_oc=AdmglsWEOCLD2eteJyIFDC_EGgx-XoPad10mU5c-3g4Omeidi8JQToGeIaXkAekjuvY&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=awrmzproztrutzkCMDde9Q&oh=00_AfmgtkaocS5CoU3uFWtrfInUjM-EGYRUyU35tfuX1OUVKQ&oe=6946F596", "thumbnails": [ { "url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/563463663_701381875690898_6935019733953855836_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=50ce42&_nc_ohc=eWMwUxL2MgIQ7kNvwF7WgGw&_nc_oc=AdmglsWEOCLD2eteJyIFDC_EGgx-XoPad10mU5c-3g4Omeidi8JQToGeIaXkAekjuvY&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=awrmzproztrutzkCMDde9Q&oh=00_AfmgtkaocS5CoU3uFWtrfInUjM-EGYRUyU35tfuX1OUVKQ&oe=6946F596", "id": "0" } ], "ext": "mp4", "video_ext": "mp4", "http_headers": { "User-Agent": "facebookexternalhit/1.1", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", "Accept-Language": "en-us,en;q=0.5", "Sec-Fetch-Mode": "navigate" }, "width": 0, "height": 0, "video_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQMQyzEdKB86VUrrvTKqd76B4EDmHjeRcxUXPeRqb6ssY1QwvaKvbyHOTeyctooRzOh5pPQfx5zEBLNiAhfYktExplH30kRGrFxsJw4iKg.mp4?_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=gxmyXsgpcLsQ7kNvwGtygrp&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNTA4LnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTUxODQ4MDUyOTE3NTQ0NywiYXNzZXRfYWdlX2RheXMiOjYzLCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTA3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=awrmzproztrutzkCMDde9Q&_nc_zt=28&oh=00_AfkXogKkSU76x5qzGrZ-8wOaOeIWM0dFRSC96bJdtoWCjg&oe=6946D87F&bitrate=613874&tag=sve_sd", "share_urls": { "facebook": "https://www.facebook.com/sharer/sharer.php?u=https://m.facebook.com/watch/?v=1378841030316664&_rdr", "twitter": "https://twitter.com/intent/tweet?url=https://m.facebook.com/watch/?v=1378841030316664&_rdr", "linkedin": "https://www.linkedin.com/sharing/share-offsite/?url=https://m.facebook.com/watch/?v=1378841030316664&_rdr" }, "hashtags": [ "venom", "arabic", "funnyvideos", "management", "managementconsulting" ], "privacy": "public", "resolution": "", "page_category": "video.other" }, { "id": "1028061379391984", "title": "854K reactions · 21K shares | এমন একজনকে চাই যে আমাকে ঠিক এভাবেই আগলে রাখবে সারা জীবন 😇😇🥀 #FBTrending #viralchallenge #ViralFacebook #koreanmix #bts #kpop #korea #korean #musicvideo #drama #kdrama #koreanstyle #mix #fangirl #southkorea #leeminho #koreandrama #sulamalis #koreanmodel #sulamalisjakarta #koreandramas #kursussulamalis #sulamaliskorea #sulamalisnatural #heartbrokenlovestory | Arohi Islam", "upload_date": "2025-05-12", "description": "এমন একজনকে চাই যে আমাকে ঠিক এভাবেই আগলে রাখবে সারা জীবন 😇😇🥀\n#FBTrending #viralchallenge #ViralFacebook \n#koreanmix #bts #kpop #korea #korean #musicvideo #drama #kdrama #koreanstyle #mix #fangirl #southkorea #leeminho #koreandrama #sulamalis #koreanmodel #sulamalisjakarta #koreandramas #kursussulamalis #sulamaliskorea #sulamalisnatural #heartbrokenlovestory", "view_count": "11.7M", "concurrent_view_count": "0", "uploader": "Arohi Islam", "uploader_id": "61550107526664", "platform": "facebook", "extractor": "facebook", "extractor_key": "Facebook", "webpage_url": "https://www.facebook.com/watch?v=1028061379391984", "webpage_url_basename": "watch", "original_url": "https://www.facebook.com/watch?v=1028061379391984", "timestamp": "2025-05-12", "timestamp_iso": "2025-05-12T06:34:13Z", "duration": "14m 40s", "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/497138445_575803558876566_760069044987240158_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=50ce42&_nc_ohc=XeA1TqLiD6IQ7kNvwFmHhS5&_nc_oc=AdmHwfETlTPZ-PwNJO2O7vwj8rzojXw0HVYqOeqRC6aZG6rsMAvvkLKVekT9AvVc_jE&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=p0QGDYqDtg8-jaReySYNEw&oh=00_AfnrSPBeGAwd3c0-4HFDbTM8nU09C7T9FCAoQZCutuYHxw&oe=6946FEA9", "thumbnails": [ { "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/497138445_575803558876566_760069044987240158_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=50ce42&_nc_ohc=XeA1TqLiD6IQ7kNvwFmHhS5&_nc_oc=AdmHwfETlTPZ-PwNJO2O7vwj8rzojXw0HVYqOeqRC6aZG6rsMAvvkLKVekT9AvVc_jE&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=p0QGDYqDtg8-jaReySYNEw&oh=00_AfnrSPBeGAwd3c0-4HFDbTM8nU09C7T9FCAoQZCutuYHxw&oe=6946FEA9", "id": "0" } ], "ext": "mp4", "video_ext": "mp4", "http_headers": { "User-Agent": "facebookexternalhit/1.1", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", "Accept-Language": "en-us,en;q=0.5", "Sec-Fetch-Mode": "navigate" }, "width": 0, "height": 0, "video_url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMWsGc-JZerOZvitel27XJgBBtd6Scr2OrsiL-F9OR5JcZIHmAF2FwgZCwoJwHNb0p6oTz31V4CCAIHryKDr3kJ.mp4?_nc_cat=104&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=x4pEgoQ1-TsQ7kNvwGAU8ZF&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjQwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NzAzOTYzNjA4ODc5ODE3LCJhc3NldF9hZ2VfZGF5cyI6MjE4LCJ2aV91c2VjYXNlX2lkIjoxMDEyMywiZHVyYXRpb25fcyI6ODgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=p0QGDYqDtg8-jaReySYNEw&_nc_zt=28&oh=00_AfkuwztF-jnMP7bf1oHe46eJEGBALrT_iI9jt9ey-WnYBg&oe=6946D52D&bitrate=276243&tag=sve_sd", "share_urls": { "facebook": "https://www.facebook.com/sharer/sharer.php?u=https://www.facebook.com/watch?v=1028061379391984", "twitter": "https://twitter.com/intent/tweet?url=https://www.facebook.com/watch?v=1028061379391984", "linkedin": "https://www.linkedin.com/sharing/share-offsite/?url=https://www.facebook.com/watch?v=1028061379391984" }, "hashtags": [ "FBTrending", "viralchallenge", "ViralFacebook", "koreanmix", "bts", "kpop", "korea", "korean", "musicvideo", "drama", "kdrama", "koreanstyle", "mix", "fangirl", "southkorea", "leeminho", "koreandrama", "sulamalis", "koreanmodel", "sulamalisjakarta", "koreandramas", "kursussulamalis", "sulamaliskorea", "sulamalisnatural", "heartbrokenlovestory" ], "privacy": "public", "resolution": "", "page_category": "video.other" }, { "id": "24830791633264689", "title": "1.6M views · 41K reactions | Aquaman 2 Movie 🎥🍿 #fbreelsfypシ゚viralシ #cctoownerofthisvideo #actionmovie | Lead Scout Paragile Jr.", "upload_date": "2025-12-12", "description": "Aquaman 2 Movie 🎥🍿 \n#fbreelsfypシ゚viralシ \n#cctoownerofthisvideo \n#actionmovie", "view_count": "1.2M", "concurrent_view_count": "0", "uploader": "Lead Scout Paragile Jr.", "uploader_id": "100012795257635", "platform": "facebook", "extractor": "facebook", "extractor_key": "Facebook", "webpage_url": "https://www.facebook.com/watch?v=24830791633264689", "webpage_url_basename": "watch", "original_url": "https://www.facebook.com/watch?v=24830791633264689", "timestamp": "2025-12-12", "timestamp_iso": "2025-12-12T13:23:10Z", "duration": "2m 20s", "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/596050478_2006892259854824_8602318700205242351_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=50ce42&_nc_ohc=DEoWNWIA0HoQ7kNvwEftvTN&_nc_oc=AdnOhFgBd1C-ovsE4L9KZCHwl7pVE1ymBLD6QlrkH2kE9b1O8yrG7L2A3L_YZAgL9QQ&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=9ss2s5ruXGqGMUUwxUoarw&oh=00_Afkr2UG9htNB5baPOVI6XP5JKpq1NE5Jy5H1MCjb8nNOBw&oe=694704C4", "thumbnails": [ { "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/596050478_2006892259854824_8602318700205242351_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=50ce42&_nc_ohc=DEoWNWIA0HoQ7kNvwEftvTN&_nc_oc=AdnOhFgBd1C-ovsE4L9KZCHwl7pVE1ymBLD6QlrkH2kE9b1O8yrG7L2A3L_YZAgL9QQ&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=9ss2s5ruXGqGMUUwxUoarw&oh=00_Afkr2UG9htNB5baPOVI6XP5JKpq1NE5Jy5H1MCjb8nNOBw&oe=694704C4", "id": "0" } ], "ext": "mp4", "video_ext": "mp4", "http_headers": { "User-Agent": "facebookexternalhit/1.1", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", "Accept-Language": "en-us,en;q=0.5", "Sec-Fetch-Mode": "navigate" }, "width": 0, "height": 0, "automatic_captions": { "en_US": [ { "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.2093-6/597241142_24830841766593009_1954644159720907920_n.srt?_nc_cat=108&ccb=1-7&_nc_sid=c211c2&_nc_ohc=RqdcBveUmdoQ7kNvwHDB91g&_nc_oc=AdkS3Rmhk3XxmP3BonebNV4huTPsIZQWGBBgC51tOzAM0tuL3Jo0oGDzFSIhJgqTrLM&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=9ss2s5ruXGqGMUUwxUoarw&oh=00_AflTbCeibk1q5fVtriBZ3riYhOVyJ5IAKifMmmzOYiJgBg&oe=6946EE1A", "name": "English", "ext": "srt" } ] }, "video_url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQNZcZlQwtLvqDtc63wkOKMWjwD1CbwDFSqiyXMDa18Kw0SKLuA-LxXtRf86HZdLeojLfSHd_301Au6oOw0z0DO4mgthkdK96cGH49j6jQ.mp4?_nc_cat=108&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=Zc_byHxq52kQ7kNvwGURJNj&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTM2MTY1NDYyMjM1NDg3MiwiYXNzZXRfYWdlX2RheXMiOjMsInZpX3VzZWNhc2VfaWQiOjEwMTIzLCJkdXJhdGlvbl9zIjoxNDAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=9ss2s5ruXGqGMUUwxUoarw&_nc_zt=28&oh=00_AfmIhvuXNJBSO0tfYnVDkohI3I8eI50ErrxGkJLfWSqhUw&oe=6946F032&bitrate=503767&tag=sve_sd", "share_urls": { "facebook": "https://www.facebook.com/sharer/sharer.php?u=https://www.facebook.com/watch?v=24830791633264689", "twitter": "https://twitter.com/intent/tweet?url=https://www.facebook.com/watch?v=24830791633264689", "linkedin": "https://www.linkedin.com/sharing/share-offsite/?url=https://www.facebook.com/watch?v=24830791633264689" }, "hashtags": [ "fbreelsfypシ", "cctoownerofthisvideo", "actionmovie" ], "privacy": "public", "resolution": "", "page_category": "video.other" }, { "id": "1028061379391984", "title": "854K reactions · 21K shares | এমন একজনকে চাই যে আমাকে ঠিক এভাবেই আগলে রাখবে সারা জীবন 😇😇🥀 #FBTrending #viralchallenge #ViralFacebook #koreanmix #bts #kpop #korea #korean #musicvideo #drama #kdrama #koreanstyle #mix #fangirl #southkorea #leeminho #koreandrama #sulamalis #koreanmodel #sulamalisjakarta #koreandramas #kursussulamalis #sulamaliskorea #sulamalisnatural #heartbrokenlovestory | Arohi Islam", "upload_date": "2025-05-12", "description": "এমন একজনকে চাই যে আমাকে ঠিক এভাবেই আগলে রাখবে সারা জীবন 😇😇🥀\n#FBTrending #viralchallenge #ViralFacebook \n#koreanmix #bts #kpop #korea #korean #musicvideo #drama #kdrama #koreanstyle #mix #fangirl #southkorea #leeminho #koreandrama #sulamalis #koreanmodel #sulamalisjakarta #koreandramas #kursussulamalis #sulamaliskorea #sulamalisnatural #heartbrokenlovestory", "view_count": "11.7M", "concurrent_view_count": "0", "uploader": "Arohi Islam", "uploader_id": "61550107526664", "platform": "facebook", "extractor": "facebook", "extractor_key": "Facebook", "webpage_url": "https://www.facebook.com/ArohiIslam8/videos/1028061379391984/", "webpage_url_basename": "1028061379391984", "original_url": "https://www.facebook.com/ArohiIslam8/videos/1028061379391984/", "timestamp": "2025-05-12", "timestamp_iso": "2025-05-12T06:34:13Z", "duration": "14m 40s", "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/497138445_575803558876566_760069044987240158_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=50ce42&_nc_ohc=XeA1TqLiD6IQ7kNvwFmHhS5&_nc_oc=AdmHwfETlTPZ-PwNJO2O7vwj8rzojXw0HVYqOeqRC6aZG6rsMAvvkLKVekT9AvVc_jE&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=wcWCOci00LkaZRZ3AU2u2w&oh=00_AfkVluGZiOZEAM10fAnd-2LvzZtAP5hbXT1XnEKHCRrNaA&oe=6946FEA9", "thumbnails": [ { "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/497138445_575803558876566_760069044987240158_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=50ce42&_nc_ohc=XeA1TqLiD6IQ7kNvwFmHhS5&_nc_oc=AdmHwfETlTPZ-PwNJO2O7vwj8rzojXw0HVYqOeqRC6aZG6rsMAvvkLKVekT9AvVc_jE&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=wcWCOci00LkaZRZ3AU2u2w&oh=00_AfkVluGZiOZEAM10fAnd-2LvzZtAP5hbXT1XnEKHCRrNaA&oe=6946FEA9", "id": "0" } ], "ext": "mp4", "video_ext": "mp4", "http_headers": { "User-Agent": "facebookexternalhit/1.1", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8", "Accept-Language": "en-us,en;q=0.5", "Sec-Fetch-Mode": "navigate" }, "width": 0, "height": 0, "video_url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQMWsGc-JZerOZvitel27XJgBBtd6Scr2OrsiL-F9OR5JcZIHmAF2FwgZCwoJwHNb0p6oTz31V4CCAIHryKDr3kJ.mp4?_nc_cat=104&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=x4pEgoQ1-TsQ7kNvwGAU8ZF&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjQwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NzAzOTYzNjA4ODc5ODE3LCJhc3NldF9hZ2VfZGF5cyI6MjE4LCJ2aV91c2VjYXNlX2lkIjoxMDEyMywiZHVyYXRpb25fcyI6ODgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=wcWCOci00LkaZRZ3AU2u2w&_nc_zt=28&oh=00_Afn7OvN8giuSljIXyHhzl-DcL--tOUka2Az-Dy6UeREkWA&oe=6946D52D&bitrate=276243&tag=sve_sd", "share_urls": { "facebook": "https://www.facebook.com/sharer/sharer.php?u=https://www.facebook.com/ArohiIslam8/videos/1028061379391984/", "twitter": "https://twitter.com/intent/tweet?url=https://www.facebook.com/ArohiIslam8/videos/1028061379391984/", "linkedin": "https://www.linkedin.com/sharing/share-offsite/?url=https://www.facebook.com/ArohiIslam8/videos/1028061379391984/" }, "hashtags": [ "FBTrending", "viralchallenge", "ViralFacebook", "koreanmix", "bts", "kpop", "korea", "korean", "musicvideo", "drama", "kdrama", "koreanstyle", "mix", "fangirl", "southkorea", "leeminho", "koreandrama", "sulamalis", "koreanmodel", "sulamalisjakarta", "koreandramas", "kursussulamalis", "sulamaliskorea", "sulamalisnatural", "heartbrokenlovestory" ], "privacy": "public", "resolution": "", "page_category": "video.other" } ] --- --- ## ☁️ Apify Platform Usage Guide * 🖥️ Run directly from Apify Console * 🔗 Integrate via Apify API * 🔄 Schedule runs using Apify Scheduler * 📦 Export results to JSON, CSV, Excel, or API endpoints --- ## 🔐 Environment Variables ⚙️ This actor does not require any mandatory environment variables. 🛡️ Proxy usage is automatically managed via Apify Proxy configuration. --- ## 🚀 Performance & Limits * ⚡ Extremely fast metadata-only extraction * 📉 Low memory and CPU usage * 🌍 Supports all public Facebook video URLs * 🧱 Subject to Facebook regional & availability restrictions --- ## 🧯 Error Handling & Edge Cases * 🚫 Private or deleted videos are skipped gracefully * 🔁 Automatic retry with proxy on failure * 🧠 Playlist URLs return first available entry * 📭 Empty results are safely ignored --- ## 🧠 Best Practices * 🔗 Always provide direct video URLs * 🌐 Enable Residential Proxy for high-volume scraping * 📊 Use maxItems for controlled batch runs * 🧪 Test with a single URL before scaling --- ## 💼 Common Use Cases * 📊 Social media analytics * 📈 Engagement & trend monitoring * 📰 Media research & archiving * 🤖 Automation pipelines * 🧠 AI training datasets (metadata only) --- ## ⚠️ Notes & Warnings * 🚫 This actor does NOT download video files * 🔐 Private, restricted, or age-gated videos may not return data * 🌍 Facebook behavior may change without notice --- ## ⚖️ Legal & Compliance Disclaimer 📜 This actor is provided for educational, research, and automation purposes only. 🛑 Users are solely responsible for: * Complying with Facebook Terms of Service * Respecting local laws and regulations * Ensuring ethical and lawful data usage ## Fields | Section | Notable Fields | Description | | -------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | | video | id, desc, date, duration, videoUrl, playAddr, downloadAddr, ratio, cover, statistics | Core video metadata, formatted duration, humanized counts | | user | uniqueId, nickname, avatarThumb, verified, secUid | Author identity and profile data, if available | | music | id, title, playUrl, coverThumb, authorName | Linked audio metadata | | challenges | title, desc, cover | Associated hashtags or challenges | | meta | region, language, isAd, duetEnabled, stitchEnabled, labels | Extra flags and content categorization | --- ## Troubleshooting 🛠 | Issue | Likely cause | Suggested fix | | --------------------- | -------------------------------------------- | ----------------------------------------------------------------------- | | Empty dataset | URL not public or blocked by Facebook | Ensure URL is public; enable RESIDENTIAL proxy | | Partial metadata | Some fields absent on the page | That’s expected — fields appear only if present in the page JSON | | Failures / timeouts | Network blocks, proxy misconfigured | Use Apify Proxy (RESIDENTIAL), increase timeout, enable sticky sessions | | Actor input not found | Wrong input shape (e.g. missing startUrls) | Use startUrls, url, or urls as shown in examples | --- --- ## 📬 Support & Contact 📧 For feature requests, custom actors, or enterprise solutions: alphascraper69@gmail.com** ---