🌟 Facebook Video Scraper & Downloader ## One-line hero Capture public Facebook videos at scale — instant, privacy-safe downloads with rich metadata for research, monitoring, and analysis. --- ## 📖 Short summary This production-ready Apify Actor scrapes public Facebook video pages, collects titles, timestamps, view/like/comment counts and other metadata, and downloads high-quality H.264 MP4s ready for analysis or archival. Plug-and-play: run in Console and get structured results in seconds. --- ## 💡 Use cases / When to use * Research: collect video metadata for trend analysis and sentiment studies. * Content monitoring: archive public videos and thumbnails for watchlists. * Media teams: bulk-download publisher videos for offline review and editing. * Data pipelines: feed normalized video records into analytics or ML workflows. --- ## ⚡ Quick Start (Console — one-click) 1. Go to Apify Console and open this Actor. 2. Paste one or more public Facebook video URLs into the Input field (see examples below). 3. Click Run — results (Dataset + KV files) appear instantly when finished. Runs in seconds for single URLs; built for high-volume runs with configurable concurrency. --- ## ⚙️ Quick Start (CLI + API) CLI (one-liner) bash apify run --actor <USERNAME>/<ACTOR_NAME> --input input.example.json Python (apify-client) — one snippet python from apify_client import ApifyClient client = ApifyClient('<APIFY_TOKEN>') run_input = { "startUrls": ["https://www.facebook.com/watch/?v=1234567890"], "download": True, "desired_resolution": "1080p" } # Call the actor (sync) result = client.actor('<USERNAME>/<ACTOR_NAME>').call(run_input=run_input) print(result) --- ## 📝 Inputs (fields & schema) This actor accepts a JSON input. Minimal and common fields are shown below. Console JSON input example (also saved as input.example.json): json { "startUrls": [ "https://www.facebook.com/watch/?v=1234567890" ], "download": true, "desired_resolution": "1080p", "preserve_downloads": false, "maxConcurrency": 5, "cookiesFile": "", "proxyConfiguration": { "useApifyProxy": true } } Accepted input aliases: startUrls, start_urls, startUrl, url. --- ## ⚙️ Configuration (Console inputs) | 🔑 Name | 📝 Type | ❓ Required | ⚙️ Default | 📌 Example | 🧠 Notes | | ------------------ | -------------: | :---------: | ------------------------- | ---------------------------- | --------------------------------------------- | | startUrls | array / string | ✅ Yes | None | ["https://...watch?v=123"] | Primary list of public video URLs | | download | boolean | ⚙️ Optional | false | true | Whether to download video files | | desired_resolution | string | ⚙️ Optional | 1080p | 720p, 1080p | Max height to prefer for downloads | | preserve_downloads | boolean | ⚙️ Optional | false | true | Keep local files after storing to KV | | cookiesFile | string | ⚙️ Optional | "" | "/path/cookies.txt" | Path to cookies file if needed | | proxyConfiguration | object | ⚙️ Optional | { useApifyProxy: true } | { "useApifyProxy": true } | Apify Proxy or custom proxy settings | | maxConcurrency | integer | ⚙️ Optional | 5 | 10 | Controls parallel processing (1–50 suggested) | Example Console setup: paste URLs into startUrls and click Run. --- ## 📄 Outputs (Dataset / KV examples) The actor pushes structured records to the default Dataset and stores downloaded files in the Actor Key-Value store (KV). Example output record (Dataset) json [ { "platform": "facebook", "original_url": "https://web.facebook.com/share/v/17dyor2Xtk/", "_source_index": 1, "_scraped_at": "2025-11-29T06:10:39.668992Z", "yt_info": { "id": "1576120563807515", "title": "সময়ের আলো নিভে গেলে মানুষের কণ্ঠস্বরও অদৃশ্য হয়ে যায়", "duration": 23.15, "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/588641499_1837732823776160_4431502759395403545_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=Z746lcl00LkQ7kNvwFwn8oy&_nc_oc=AdkTKOIG3o0XeK09ZnT22zolUZs0bSRARmcalAP2_3i9abC5BQH3BftXObPAzB-WjmU&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&oh=00_Afj4MPDyCXJzziXeWDhK60vfZ7WJBJILEVvmxOIIKeqPzA&oe=69306E68" }, "title": "সময়ের আলো নিভে গেলে মানুষের কণ্ঠস্বরও অদৃশ্য হয়ে যায়", "duration": 23.15, "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/588641499_1837732823776160_4431502759395403545_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=Z746lcl00LkQ7kNvwFwn8oy&_nc_oc=AdkTKOIG3o0XeK09ZnT22zolUZs0bSRARmcalAP2_3i9abC5BQH3BftXObPAzB-WjmU&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&oh=00_Afj4MPDyCXJzziXeWDhK60vfZ7WJBJILEVvmxOIIKeqPzA&oe=69306E68", "webpage_url": "https://m.facebook.com/watch/?v=1576120563807515&_rdr", "id": "1576120563807515", "description": "সময়ের আলো নিভে গেলে মানুষের কণ্ঠস্বরও অদৃশ্য হয়ে যায়..", "duration_seconds": 23.15, "upload_date_raw": "20251124", "upload_date": "24th November 2025", "timestamp": 1763956863, "timestamp_iso": "2025-11-24T04:01:03Z", "view_count_raw": 202953, "view_count": "203.0K", "uploader": "Ahmed The Nature Lover", "uploader_id": "61561283450833", "extractor": "facebook", "formats": [ { "format_id": "3242077235966084a", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "m4a", "tbr": 55.518, "asr": 44100, "format_note": "DASH audio", "container": "m4a_dash", "vcodec": "none", "acodec": "mp4a.40.5", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQMPDfeAmeTSNrHIsZby0vkgRziNxfA1M8jA16g2jpSAF5FHJgC1rvyy7ff0uQrM4USgFWqy8q3y9FqOiyD51B4XSqoSvLYyPchhPCs.mp4?_nc_cat=106&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=00euDNAxgVoQ7kNvwHRuxwi&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoxNTc2MTIwNTYzODA3NTE1LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjo0MDQ2NjQ0NDIyMzEzNDkxLCJhc3NldF9hZ2VfZGF5cyI6NSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjIzLCJiaXRyYXRlIjo1NTg2MywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfjW5FF8DtlYUAXC97a-jb7FFiymfAgrw6Hz7Mhexmygqw&oe=69306D8F", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "audio_ext": "m4a", "video_ext": "none", "vbr": 0, "abr": 55.518, "resolution": "audio only", "format": "3242077235966084a - audio only (DASH audio)" }, { "format_id": "sd", "quality": -3, "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQPdBsb1QiO9n42SU08FqvlDVbn8XSWRk3c5wwC1licWOVQ3tOMy9EaEZXtyR7WBYdjtk0LjkE3EN4wcKAoqOHtR6vQcsS2aOQDMxEGbQw.mp4?_nc_cat=107&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=PHSlzfJyshIQ7kNvwEIi6i3&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjQwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NDA0NjY0NDQyMjMxMzQ5MSwiYXNzZXRfYWdlX2RheXMiOjUsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoyMywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfgnEU7-7U9d4XmXnt-2IkI3YzuA_cjrRmkeC_TzK2q7_g&oe=693071CB&bitrate=297657&tag=sve_sd", "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "ext": "mp4", "video_ext": "mp4", "audio_ext": "none", "dynamic_range": "SDR", "format": "sd - unknown" }, { "format_id": "hd", "quality": -2, "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQPOFE2u0laDVUpecNsxo-FA-5goE63hXl6oUhAmnAOE6VLWdbizU7-UOuUuM1T11mBhqKMh5ucVdkFgMMwWUBzFud-Ky48uCyePMjd788xxVg.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=-OS3K9Oz-z8Q7kNvwFFF3HN&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI4MC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjo0MDQ2NjQ0NDIyMzEzNDkxLCJhc3NldF9hZ2VfZGF5cyI6NSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjIzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=a552d1cc67d442f1&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC9DNjQwRDEwNjZENzJFQTQ4OTZENjQ3OTVDQ0I1MzVBMl9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0NBNEU5ODQ3RjdGNURCOTIyODUxQ0VFNkZBQzA2MEJBX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACammJi12pmwDhUCKAJDMywXQDcqfvnbItEYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfgxMD6N_aCzfGRt5rGmSUs2TmwNEL7mK2iHP3wzw8wPIg&oe=69305560&bitrate=1880145&tag=dash_h264-basic-gen2_720p", "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "ext": "mp4", "video_ext": "mp4", "audio_ext": "none", "dynamic_range": "SDR", "format": "hd - unknown" }, { "format_id": "1915536748996213v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "mp4", "width": 640, "height": 360, "tbr": 255.024, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.4d001e", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQNbqhKvd664FcqFW_SyazhVtq3FDMclbFAIk2EHVqgyug1EgoigoaQ2NYAjJwj0AISYKFgr0KOCgpvzWRhUwpfa94hwit_6SZJbj6wcSsADVg.mp4?_nc_cat=111&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=ovEi_OsE2gAQ7kNvwFm5uHl&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzM2MHAiLCJ2aWRlb19pZCI6MTU3NjEyMDU2MzgwNzUxNSwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6NDA0NjY0NDQyMjMxMzQ5MSwiYXNzZXRfYWdlX2RheXMiOjUsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoyMywiYml0cmF0ZSI6MjQ2NDk4LCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_Afjy8PnVLCvOLJ0LNB75WFE8tlBo3EIy_5ZfRPFySrUgkw&oe=693051D5", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "video_ext": "mp4", "audio_ext": "none", "abr": 0, "vbr": 255.024, "resolution": "640x360", "aspect_ratio": 1.78, "format": "1915536748996213v - 640x360 (DASH video)" }, { "format_id": "854835280833368v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "mp4", "width": 1280, "height": 720, "tbr": 1916.927, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.64001f", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQPOFE2u0laDVUpecNsxo-FA-5goE63hXl6oUhAmnAOE6VLWdbizU7-UOuUuM1T11mBhqKMh5ucVdkFgMMwWUBzFud-Ky48uCyePMjd788xxVg.mp4?_nc_cat=104&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=-OS3K9Oz-z8Q7kNvwFFF3HN&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ2aWRlb19pZCI6MTU3NjEyMDU2MzgwNzUxNSwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6NDA0NjY0NDQyMjMxMzQ5MSwiYXNzZXRfYWdlX2RheXMiOjUsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoyMywiYml0cmF0ZSI6MTgyNDI4MiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfgHFIRidQgOqXF061_U_bFi5HkZu4DGHcQVfpAMyiPbEA&oe=69305560", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "video_ext": "mp4", "audio_ext": "none", "abr": 0, "vbr": 1916.927, "resolution": "1280x720", "aspect_ratio": 1.78, "format": "854835280833368v - 1280x720 (DASH video)" } ], "thumbnails": [ { "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/588641499_1837732823776160_4431502759395403545_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=Z746lcl00LkQ7kNvwFwn8oy&_nc_oc=AdkTKOIG3o0XeK09ZnT22zolUZs0bSRARmcalAP2_3i9abC5BQH3BftXObPAzB-WjmU&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&oh=00_Afj4MPDyCXJzziXeWDhK60vfZ7WJBJILEVvmxOIIKeqPzA&oe=69306E68", "id": "0" } ], "raw_json": { "title": "সময়ের আলো নিভে গেলে মানুষের কণ্ঠস্বরও অদৃশ্য হয়ে যায়", "description": "সময়ের আলো নিভে গেলে মানুষের কণ্ঠস্বরও অদৃশ্য হয়ে যায়..", "uploader": "Ahmed The Nature Lover", "uploader_id": "61561283450833", "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/588641499_1837732823776160_4431502759395403545_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=Z746lcl00LkQ7kNvwFwn8oy&_nc_oc=AdkTKOIG3o0XeK09ZnT22zolUZs0bSRARmcalAP2_3i9abC5BQH3BftXObPAzB-WjmU&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&oh=00_Afj4MPDyCXJzziXeWDhK60vfZ7WJBJILEVvmxOIIKeqPzA&oe=69306E68", "view_count": 202953, "concurrent_view_count": 0, "duration": 23.15, "id": "1576120563807515", "formats": [ { "format_id": "3242077235966084a", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "m4a", "tbr": 55.518, "asr": 44100, "format_note": "DASH audio", "container": "m4a_dash", "vcodec": "none", "acodec": "mp4a.40.5", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQMPDfeAmeTSNrHIsZby0vkgRziNxfA1M8jA16g2jpSAF5FHJgC1rvyy7ff0uQrM4USgFWqy8q3y9FqOiyD51B4XSqoSvLYyPchhPCs.mp4?_nc_cat=106&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=00euDNAxgVoQ7kNvwHRuxwi&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoxNTc2MTIwNTYzODA3NTE1LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjo0MDQ2NjQ0NDIyMzEzNDkxLCJhc3NldF9hZ2VfZGF5cyI6NSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjIzLCJiaXRyYXRlIjo1NTg2MywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfjW5FF8DtlYUAXC97a-jb7FFiymfAgrw6Hz7Mhexmygqw&oe=69306D8F", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "audio_ext": "m4a", "video_ext": "none", "vbr": 0, "abr": 55.518, "resolution": "audio only", "format": "3242077235966084a - audio only (DASH audio)" }, { "format_id": "sd", "quality": -3, "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQPdBsb1QiO9n42SU08FqvlDVbn8XSWRk3c5wwC1licWOVQ3tOMy9EaEZXtyR7WBYdjtk0LjkE3EN4wcKAoqOHtR6vQcsS2aOQDMxEGbQw.mp4?_nc_cat=107&_nc_sid=8bf8fe&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=PHSlzfJyshIQ7kNvwEIi6i3&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjQwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NDA0NjY0NDQyMjMxMzQ5MSwiYXNzZXRfYWdlX2RheXMiOjUsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoyMywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfgnEU7-7U9d4XmXnt-2IkI3YzuA_cjrRmkeC_TzK2q7_g&oe=693071CB&bitrate=297657&tag=sve_sd", "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "ext": "mp4", "video_ext": "mp4", "audio_ext": "none", "dynamic_range": "SDR", "format": "sd - unknown" }, { "format_id": "hd", "quality": -2, "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQPOFE2u0laDVUpecNsxo-FA-5goE63hXl6oUhAmnAOE6VLWdbizU7-UOuUuM1T11mBhqKMh5ucVdkFgMMwWUBzFud-Ky48uCyePMjd788xxVg.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=-OS3K9Oz-z8Q7kNvwFFF3HN&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI4MC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjo0MDQ2NjQ0NDIyMzEzNDkxLCJhc3NldF9hZ2VfZGF5cyI6NSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjIzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=a552d1cc67d442f1&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC9DNjQwRDEwNjZENzJFQTQ4OTZENjQ3OTVDQ0I1MzVBMl9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0NBNEU5ODQ3RjdGNURCOTIyODUxQ0VFNkZBQzA2MEJBX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACammJi12pmwDhUCKAJDMywXQDcqfvnbItEYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfgxMD6N_aCzfGRt5rGmSUs2TmwNEL7mK2iHP3wzw8wPIg&oe=69305560&bitrate=1880145&tag=dash_h264-basic-gen2_720p", "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "ext": "mp4", "video_ext": "mp4", "audio_ext": "none", "dynamic_range": "SDR", "format": "hd - unknown" }, { "format_id": "1915536748996213v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "mp4", "width": 640, "height": 360, "tbr": 255.024, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.4d001e", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQNbqhKvd664FcqFW_SyazhVtq3FDMclbFAIk2EHVqgyug1EgoigoaQ2NYAjJwj0AISYKFgr0KOCgpvzWRhUwpfa94hwit_6SZJbj6wcSsADVg.mp4?_nc_cat=111&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=ovEi_OsE2gAQ7kNvwFm5uHl&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzM2MHAiLCJ2aWRlb19pZCI6MTU3NjEyMDU2MzgwNzUxNSwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6NDA0NjY0NDQyMjMxMzQ5MSwiYXNzZXRfYWdlX2RheXMiOjUsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoyMywiYml0cmF0ZSI6MjQ2NDk4LCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_Afjy8PnVLCvOLJ0LNB75WFE8tlBo3EIy_5ZfRPFySrUgkw&oe=693051D5", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "video_ext": "mp4", "audio_ext": "none", "abr": 0, "vbr": 255.024, "resolution": "640x360", "aspect_ratio": 1.78, "format": "1915536748996213v - 640x360 (DASH video)" }, { "format_id": "854835280833368v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "mp4", "width": 1280, "height": 720, "tbr": 1916.927, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.64001f", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQPOFE2u0laDVUpecNsxo-FA-5goE63hXl6oUhAmnAOE6VLWdbizU7-UOuUuM1T11mBhqKMh5ucVdkFgMMwWUBzFud-Ky48uCyePMjd788xxVg.mp4?_nc_cat=104&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=-OS3K9Oz-z8Q7kNvwFFF3HN&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ2aWRlb19pZCI6MTU3NjEyMDU2MzgwNzUxNSwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6NDA0NjY0NDQyMjMxMzQ5MSwiYXNzZXRfYWdlX2RheXMiOjUsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoyMywiYml0cmF0ZSI6MTgyNDI4MiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfgHFIRidQgOqXF061_U_bFi5HkZu4DGHcQVfpAMyiPbEA&oe=69305560", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "video_ext": "mp4", "audio_ext": "none", "abr": 0, "vbr": 1916.927, "resolution": "1280x720", "aspect_ratio": 1.78, "format": "854835280833368v - 1280x720 (DASH video)" } ], "timestamp": 1763956863, "automatic_captions": {}, "subtitles": {}, "original_url": "https://web.facebook.com/share/v/17dyor2Xtk/", "webpage_url": "https://m.facebook.com/watch/?v=1576120563807515&_rdr", "webpage_url_basename": "watch", "webpage_url_domain": "m.facebook.com", "extractor": "facebook", "extractor_key": "Facebook", "thumbnails": [ { "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/588641499_1837732823776160_4431502759395403545_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=be8305&_nc_ohc=Z746lcl00LkQ7kNvwFwn8oy&_nc_oc=AdkTKOIG3o0XeK09ZnT22zolUZs0bSRARmcalAP2_3i9abC5BQH3BftXObPAzB-WjmU&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&oh=00_Afj4MPDyCXJzziXeWDhK60vfZ7WJBJILEVvmxOIIKeqPzA&oe=69306E68", "id": "0" } ], "display_id": "1576120563807515", "fulltitle": "সময়ের আলো নিভে গেলে মানুষের কণ্ঠস্বরও অদৃশ্য হয়ে যায়", "duration_string": "23", "upload_date": "20251124", "epoch": 1764396641, "requested_formats": [ { "format_id": "854835280833368v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "mp4", "width": 1280, "height": 720, "tbr": 1916.927, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.64001f", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQPOFE2u0laDVUpecNsxo-FA-5goE63hXl6oUhAmnAOE6VLWdbizU7-UOuUuM1T11mBhqKMh5ucVdkFgMMwWUBzFud-Ky48uCyePMjd788xxVg.mp4?_nc_cat=104&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=-OS3K9Oz-z8Q7kNvwFFF3HN&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ2aWRlb19pZCI6MTU3NjEyMDU2MzgwNzUxNSwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6NDA0NjY0NDQyMjMxMzQ5MSwiYXNzZXRfYWdlX2RheXMiOjUsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoyMywiYml0cmF0ZSI6MTgyNDI4MiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfgHFIRidQgOqXF061_U_bFi5HkZu4DGHcQVfpAMyiPbEA&oe=69305560", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "video_ext": "mp4", "audio_ext": "none", "abr": 0, "vbr": 1916.927, "resolution": "1280x720", "aspect_ratio": 1.78, "format": "854835280833368v - 1280x720 (DASH video)" }, { "format_id": "3242077235966084a", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=1576120563807515&dummy=.mpd", "ext": "m4a", "tbr": 55.518, "asr": 44100, "format_note": "DASH audio", "container": "m4a_dash", "vcodec": "none", "acodec": "mp4a.40.5", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQMPDfeAmeTSNrHIsZby0vkgRziNxfA1M8jA16g2jpSAF5FHJgC1rvyy7ff0uQrM4USgFWqy8q3y9FqOiyD51B4XSqoSvLYyPchhPCs.mp4?_nc_cat=106&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=00euDNAxgVoQ7kNvwHRuxwi&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoxNTc2MTIwNTYzODA3NTE1LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjo0MDQ2NjQ0NDIyMzEzNDkxLCJhc3NldF9hZ2VfZGF5cyI6NSwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjIzLCJiaXRyYXRlIjo1NTg2MywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pppkgsYan7lRqr1hsrJL2Q&_nc_zt=28&oh=00_AfjW5FF8DtlYUAXC97a-jb7FFiymfAgrw6Hz7Mhexmygqw&oe=69306D8F", "manifest_stream_number": 0, "is_dash_periods": true, "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.9", "Sec-Fetch-Mode": "navigate" }, "downloader_options": { "http_chunk_size": 262144000 }, "protocol": "https", "audio_ext": "m4a", "video_ext": "none", "vbr": 0, "abr": 55.518, "resolution": "audio only", "format": "3242077235966084a - audio only (DASH audio)" } ], "format": "854835280833368v - 1280x720 (DASH video)+3242077235966084a - audio only (DASH audio)", "format_id": "854835280833368v+3242077235966084a", "ext": "mp4", "protocol": "https+https", "format_note": "DASH video+DASH audio", "tbr": 1972.445, "width": 1280, "height": 720, "resolution": "1280x720", "dynamic_range": "SDR", "vcodec": "avc1.64001f", "vbr": 1916.927, "aspect_ratio": 1.78, "acodec": "mp4a.40.5", "abr": 55.518, "asr": 44100 }, "kv_files": { "final": { "kv_key": "MEDIA_1576120563807515_final.mp4", "local": "/app/output/MEDIA_1576120563807515_final.mp4" } }, "download_links": { "final_kv": "MEDIA_1576120563807515_final.mp4", "final_local": "/app/output/MEDIA_1576120563807515_final.mp4", "final_direct_url": "https://api.apify.com/v2/key-value-stores/~/records/MEDIA_1576120563807515_final.mp4" } } ] Where to find files * Dataset: Apify Console → Storage → Datasets (this run) * Downloaded videos: Apify Console → Storage → Key-value store → record <kv_key> (or direct download link if available) --- ## 🔑 Environment Variables / Secrets * <APIFY_TOKEN> — Apify API token (store as secret in Console or as env var locally) * <PROXY_USER:PASS@HOST:PORT> — custom proxy example (use only when not using Apify Proxy) > ⚠️ Always store tokens and proxy credentials as secrets (do NOT paste credentials into the Input field or public logs). --- ## ▶️ How to Run (detailed) Apify Console 1. Open this Actor in Apify Console. 2. Paste input.example.json or fill fields directly. 3. Click Run. Monitor progress in Logs and view results in Storage. apify-cli bash apify run --actor <USERNAME>/<ACTOR_NAME> --input input.example.json apify-client (API) — call the Actor programmatically (see snippet above). --- ## ⏰ Scheduling & Webhooks * Schedule: In Apify Console, use the Schedule tab to run this Actor periodically (hourly/daily). * Webhooks: Configure a webhook in the Settings / Webhooks to receive run-complete notifications or to trigger downstream pipelines. --- ## 🕾️ Logs & Troubleshooting * Logs: open the run → Logs in Apify Console. * Common issues & quick fixes: * No startUrls provided — add one or more public video URLs to startUrls. * Download failed — try enabling proxyConfiguration or provide a cookies file if the video requires a login/session. * Large runs timing out — reduce maxConcurrency or enable proxy rotation (see CONFIG.md). --- ## 🔒 Permissions & Storage Notes * Storage used: Dataset for structured JSON records; Key-Value store for media files. * Privacy & safety: This Actor only accesses public video pages. Do not use it to scrape private content or bypass access controls. It is designed to be privacy-safe and secure by default. --- ## 🔟 Changelog / Versioning * v1.0.0 — Production-ready initial release: metadata extraction, H.264-first downloads, KV storage, normalized Dataset output. --- ## 🖌 Notes / TODOs * TODO: confirm exact output schema keys for downstream pipelines (inferred from internals). * TODO: add demo GIF/screenshots to improve conversion. --- ## 🌍 Proxy Configuration Quick: enable Apify Proxy in Console (toggle in Input → proxyConfiguration) for reliable scraping. Custom proxy example (store credentials as secret): * HTTP_PROXY / HTTPS_PROXY env vars: http://<PROXY_USER:PASS@HOST:PORT> * Input field example: {"useApifyProxy": false, "proxyUrls": ["http://<PROXY_USER:PASS@HOST:PORT>"]} Security notes: * Never store proxy credentials in plaintext in the Input JSON. Use Console secrets. * TODO: Consider proxy rotation for large-scale scraping. --- ## 📚 References * Apify Actor README guidelines: https://docs.apify.com/actors/README * Input/Output schema patterns: https://docs.apify.com/actors/input-output * apify-cli & apify-client docs: https://docs.apify.com/tools --- ## 🤔 What I inferred from main.py * The Actor fetches info from public Facebook video pages and prefers H.264 (AVC) formats. * It extracts metadata (title, duration, timestamps, view/like/comment counts) and normalizes records for Dataset output. * Downloads are stored in Key-Value store; Dataset contains JSON records referencing KV keys. * There is optional cookie support, concurrency control, and Apify Proxy integration. * The Actor skips Facebook Reels (explicit check) and focuses on standard video pages. --- ## ✅ Why this Actor Short: Instant insights, secure by design, and production-ready — save time, get structured video data fast, and integrate into analytics or monitoring pipelines with zero setup. Run this Actor on Apify Console — get results in seconds.