Facebook-Video-Downloader-advanced 🎯Extract Facebook video metadata and download highest-quality video and audio streams with stable, predictable filenames. Optimized for Apify actors and local use. Fast, reliable, and easy to configure. 🔥📥 ## Overview This actor extracts metadata from Facebook videos , selects automaticlly the best available video and audio formats, downloads streams into a downloads/ folder, and writes a consolidated data_result.json. It pushes results to the Apify default dataset when run as an Apify Actor. Key features: * Picks highest-resolution video stream (prefers combined video+audio on ties) * Picks best audio stream (highest abr) * Falls back to combined/merged URL when separate streams unavailable * Predictable filenames: downloads/<title>_<format_id>.<ext> * Writes data_result.json with output metadata * Pushes each item to Apify dataset when used as an Actor --- ## What the actor outputs For each processed URL the actor produces an object with the following fields (saved in dataset and data_result.json): * url — the original URL processed * title — video title (if available) * duration — video duration in seconds (if available) * description — video description (if available) * resolution — selected resolution (e.g. 1920x1080 or 720p) * thumbnail_url — thumbnail image URL * audio_download_url — direct URL chosen for audio stream (only audio URL) * video_download_url — direct URL chosen for video stream (only video URL) * merge_video_download_url — merged/combined stream URL if present in extractor(Audio + video) * _best_video_format — metadata about selected video format (id, ext, height) * _best_audio_format — metadata about selected audio format (id, ext, abr) * fetched_at — UTC timestamp when data was fetched --- ## Example input : json { "startUrls": [ { "url": "https://www.facebook.com/share/v/16Sz39SU12/" }, { "url": "https://www.facebook.com/watch?v=1390942842608591" }, { "url": "https://www.facebook.com/watch.bongo/videos/1554978985535088" } ] } --- ## Example output : json [ { "url": "https://www.facebook.com/share/v/16Sz39SU12/", "title": "Steppenwolf rediscovered the Anti-Life Equation that Darkseid had forgotten on Earth", "duration": 175.079, "description": "Steppenwolf rediscovered the Anti-Life Equation that Darkseid had forgotten on Earth\n#DC #JusticeLeague #movies #shortsvideos", "resolution": "1440x1920", "thumbnail_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/551826820_1443410760048778_7695319258178519734_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=be8305&_nc_ohc=T1_-nZI9k6AQ7kNvwF1VQOa&_nc_oc=Adle8AhTBu8BaqWNFDd7MFd8uOpmm4-1-umP1IfjwDIXvEFHo8wHlGcYv4HnbHHutZo&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=FnozwpdRL-0wuqTlswcBew&oh=00_Afk5a_gvrvPSYtxl6mVxsXpWMgBqLpCPg6EGH3qgJWg84w&oe=693AEC41", "audio_download_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQPsS21mXGCLpwS9CBe9qPTcDZKupUxXj7POrb7vf6v3KHsEZR3buSsaGcLgNqt1mUe3WOGBBJnZeYMqL5zOgY1JcIUDGrPfiXQZrE4.mp4?_nc_cat=111&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=8NRzKG_h6u4Q7kNvwHnqurQ&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoxNDQzNDA4ODgzMzgyMjk5LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjo3MjQ3MTcwNDcyNjg0OTYsImFzc2V0X2FnZV9kYXlzIjo3OCwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjE3NSwiYml0cmF0ZSI6NjYyMTUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ==&ccb=17-1&_nc_gid=FnozwpdRL-0wuqTlswcBew&_nc_zt=28&oh=00_AfkdPO-Ry1NyM2_8TnRvHMq_853xXezEkU8eqnQIArv5uw&oe=693AE838", "video_download_url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQM9b4owi4ZkGQOodWs-DK_-UFSsFH3pKwGiDwQsVBu0t4khVcL7Bnonq-FcxV2lEarNWw-6arXwSEd0MM3fCvn7Uvf3OqdkZFQ2ZGE.mp4?_nc_cat=107&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=7LLBu7t5R1oQ7kNvwFccNBX&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfcjJhdjEtcjFnZW4ydnA5X3E5MCIsInZpZGVvX2lkIjoxNDQzNDA4ODgzMzgyMjk5LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjo3MjQ3MTcwNDcyNjg0OTYsImFzc2V0X2FnZV9kYXlzIjo3OCwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjE3NSwiYml0cmF0ZSI6NDAyNjQ2MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=FnozwpdRL-0wuqTlswcBew&_nc_zt=28&oh=00_AfkznY_NGgBYP5Gce5XA8kHFbWB5MQlYSNEHb_UaPc6yQg&oe=693ADCC0", "merge_video_download_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQN7Bb_MRj15aNWaehQOln6FD1H3WWfLDbWY6zz0FNfDZMk6vb8DNjx-C5RqcnuCTC7hbiKvjCcJxhv75ThN5deN6nghJfxhLjJAQgZqSzTsQA.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=pavzJhRo13gQ7kNvwG37EpD&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjcyNDcxNzA0NzI2ODQ5NiwiYXNzZXRfYWdlX2RheXMiOjc4LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTc1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=9a2f3dc34721c6a4&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC9CNjRCQjczMDQwNjAxRjFBNTI3RjhBNDNGODlENEJBRV9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0Y5NEE0RDk4MTE2ODdCMTdFMTY3NEU1OTI5ODk5QThBX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACagktLiisjJAhUCKAJDMywXQGXiHKwIMScYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=FnozwpdRL-0wuqTlswcBew&_nc_zt=28&oh=00_AfkoJ2n2ut-AtbqQZj4RAaoTzXf874KbaW5UHVXj6sQcBw&oe=693AC6FD&bitrate=1433703&tag=dash_h264-basic-gen2_720p", "_best_video_format": { "id": "1340791954243461v", "ext": "mp4", "height": 1920 }, "_best_audio_format": { "id": "2012689899506012a", "ext": "m4a", "abr": 66.129 }, "fetched_at": "2025-12-07T05:21:44.204705Z" }, { "url": "https://www.facebook.com/watch?v=1390942842608591", "title": "the only certainty in our life brother", "duration": 10.077, "description": "", "resolution": "1080x1920", "thumbnail_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/593087657_825254663710910_920265379496328503_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=be8305&_nc_ohc=ZKOXevJvgNoQ7kNvwGfVrMa&_nc_oc=AdkRpuBw9-BYw5wfFFHiyYfTDmctHaaIm5As0TP1honvbnHogpreoerAijEfZQVGexE&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=C24Gyzujl3P0bn1Tpb-9Pw&oh=00_AfloYvWTlGuBXX3dUITbHGofSC1FLQz2VBQNVapJ1tJryQ&oe=693AD5E8", "audio_download_url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQM163R-IU5stZCO3iokFe1QLpdPxCOjLs8R_NwVZ_2Q5u4nYYSt6LIavcqO-KNejEXEFuKl7omp376ekWq4qNREV4_0XADXN3yY9k0.mp4?_nc_cat=102&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=lUWrhOE2IzMQ7kNvwH3ntZC&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoxMzkwOTQyODQyNjA4NTkxLCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjo4NjMzMzU5MTYxNjY5NjcsImFzc2V0X2FnZV9kYXlzIjo1LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTAsImJpdHJhdGUiOjU3MzcxLCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=C24Gyzujl3P0bn1Tpb-9Pw&_nc_zt=28&oh=00_AfmZedk2wJQkONaqEtBB5QisyCWTYXK3cpzYTFTl1rGz8A&oe=693AC9DB", "video_download_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQMWIDque1h-0eeFLonRgPvnBPSVCFDEi3EMhnSXtR1m885et4grwbiQjFVwct5V3HbAnQFjef_FbQ90OujmK0Xw57qoUGfcFD7yR8U.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=G_fxLTKNMdIQ7kNvwG8z8mC&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfcjJhdjEtcjFnZW4ydnA5X3E5MCIsInZpZGVvX2lkIjoxMzkwOTQyODQyNjA4NTkxLCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjo4NjMzMzU5MTYxNjY5NjcsImFzc2V0X2FnZV9kYXlzIjo1LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTAsImJpdHJhdGUiOjYyNzcxODUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ==&ccb=17-1&_nc_gid=C24Gyzujl3P0bn1Tpb-9Pw&_nc_zt=28&oh=00_AflT3IvxTL2sVaanzcYrmiStRiAMqDzFNvpdFcixIDEp6g&oe=693AC9FE", "merge_video_download_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQNbNMIE7o1-sWgDOkWQmT7fEjVtsd5ktG0jAh_uITYDiCYtQlyp739-DkcY98oafUfRrKWucYGmQCiXfKwNC-8QvnTOqs_jDrcsyzqRrcEIZA.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=M7OORyIncIcQ7kNvwHljzf0&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzNlLjcyMC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjo4NjMzMzU5MTYxNjY5NjcsImFzc2V0X2FnZV9kYXlzIjo1LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=8030ddb86f715ed&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC82QzREN0YwNjg1NTYzQkVFNTQwOEMzMkVENDc2ODhCRF9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzdFNDMxMkRDNkQzMUIwM0QyNDNFRDZFNEIwRTU0MkIwX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbu_Nbp4cyIAxUCKANDM2UsF0AkIcrAgxJvGBlkYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwEQB1AmWUngEA&_nc_gid=C24Gyzujl3P0bn1Tpb-9Pw&_nc_zt=28&oh=00_AfkSJdfnegeiBKk8o-2JXq_qmmElPpCoeeeXb6BrrWOpoA&oe=693AD259&bitrate=3293139&tag=dash_h264-basic-gen2_720p", "_best_video_format": { "id": "25663721263233981v", "ext": "mp4", "height": 1920 }, "_best_audio_format": { "id": "818436194287647a", "ext": "m4a", "abr": 56.635 }, "fetched_at": "2025-12-07T05:21:46.034141Z" }, { "url": "https://www.facebook.com/watch.bongo/videos/1554978985535088", "title": "একটি পান সারা রাতের ঘুম কেড়ে নিলো | Solid Politics | Tamil Movie Bangla", "duration": 345.416, "description": "একটি পান সারা রাতের ঘুম কেড়ে নিলো!\n'সলিড পলিটিক্স'' মুভিটি দেখুন: https://tu.bongobd.com/S-P\n\n#movie #cinema #banglamovie #tamilmoviebangla #tamilmovie #moviecrimescene", "resolution": "1080x1080", "thumbnail_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/587029534_1323789989064801_6650720235852369653_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=105&ccb=1-7&_nc_sid=be8305&_nc_ohc=tC4EwEW4WrwQ7kNvwGLg3F_&_nc_oc=AdkuOB41yAAO-JGscJJb1xZMjk-xZEkBHPJRC4a6J1zQ-xCmMbetH8UV0dMNYxONqEM&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=vloikF4V2Wehti2xar31Qg&oh=00_AfndzFU5mVgQlLBGVaQIH4lRFhZzfwbH83M7vRNAZ5VHCg&oe=693AF576", "audio_download_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQMS9AZT5r4GfQatBF51VHTrWaP5CoJlm0M86t1cW9q1jYcUaCWZ8q-GvY-NRJZRwiI5yNtUrBGhWZIA9l4o-DUBen3MUC9hF5EoLrQ.mp4?_nc_cat=103&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=jC-0i9OynCwQ7kNvwEp9Tsr&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoxNTU0OTc4OTg1NTM1MDg4LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjoxODkzMDgwOTY0OTcxNDkzLCJhc3NldF9hZ2VfZGF5cyI6MTYsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjozNDUsImJpdHJhdGUiOjcwMzgwLCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=vloikF4V2Wehti2xar31Qg&_nc_zt=28&oh=00_Afl-ERi2yz4Ym2_XHWClyFmGkSy-is5e3uzZlb68IPcUUA&oe=693AE478", "video_download_url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQN3ixF3kV_d6w_lv3ds_cO7Q5mWyIQV_1sSPmdr5PAWolqfwLzOhoZxhFZqiAUiC0WWHgBhLiVWT_YJuOONbcjw2kJCz4CpqRWaPlU.mp4?_nc_cat=104&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=pS311lkQNaMQ7kNvwHMUdIJ&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfcjJhdjEtcjFnZW4ydnA5X3E5MCIsInZpZGVvX2lkIjoxNTU0OTc4OTg1NTM1MDg4LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjoxODkzMDgwOTY0OTcxNDkzLCJhc3NldF9hZ2VfZGF5cyI6MTYsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjozNDUsImJpdHJhdGUiOjkwNDgyMSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=vloikF4V2Wehti2xar31Qg&_nc_zt=28&oh=00_Afn-Gcgkt1duB4sK0j4O94dR5A3uOY-3i3XSrmXemoaj0g&oe=693AE61D", "merge_video_download_url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQO7ndtd7_QaP_AzHqXxg2Rn4tIFmVrEGvFYFG71iy3uRcRZ1fVMp4Agaly4m0F9zg-L8c_xRxzXbgUyku2egzYgNAa4axuqvGqNIfonywemVw.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=yFzzbHCiSacQ7kNvwF1VCAw&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjE4OTMwODA5NjQ5NzE0OTMsImFzc2V0X2FnZV9kYXlzIjoxNiwidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjM0NSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=b60894fdaa74b83d&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC85RTRDQUVGMjNBMjRFMzcwM0QxNjY1NjI0OTVGRUE4QV9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50L0JGNEE1M0I4ODA2MTg1RkUzMUMzMjBBRDQ1RDAyQTg0X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbK75Wn6O_cBhUCKAJDMywXQHWWp--dsi0YGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=vloikF4V2Wehti2xar31Qg&_nc_zt=28&oh=00_AfnnEUkJIQR_eWmvOz0AEdJ9DoV8igc5iSCRMjltG6HUGg&oe=693AD4DE&bitrate=781488&tag=dash_h264-basic-gen2_720p", "_best_video_format": { "id": "1346438976579560v", "ext": "mp4", "height": 1080 }, "_best_audio_format": { "id": "1909413037125399a", "ext": "m4a", "abr": 70.313 }, "fetched_at": "2025-12-07T05:21:48.569997Z" } ] ---