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 :

{
    "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 :

[
  {
    "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"
  }
]