🌟 Facebook Reels Scraper & Downloader ## One-line hero Instantly capture public Facebook Reels at scale — privacy-safe downloads with rich, normalized metadata for research, monitoring, and archiving. --- ## 📖 Short summary Production-ready Apify Actor that targets Facebook Reels only. It extracts titles, timestamps, views/likes/comments, normalizes records, and downloads H.264 MP4s into Apify storage. Plug-and-play — run in Console or via API and get structured results fast. --- ## 💡 Use cases / When to use * Monitor trending Reels for social listening and brand safety. * Research short-form video trends and engagement metrics. * Archive publisher Reels for editorial review or compliance. * Feed normalized Reel records into analytics and ML pipelines. --- ## ⚡ Quick Start (Console — one-click) 1. Open this Actor in Apify Console. 2. Paste one or more Facebook Reels URLs into the Input field (see input.example.json). 3. Click Run — results are stored in Dataset and media in KV when downloads are enabled. > Note: This Actor skips non-Reel URLs and will log skipped items. --- ## ⚙️ Quick Start (CLI + API) CLI (one-liner) bash apify run --actor <USERNAME>/<ACTOR_NAME> --input input.example.json Python (apify-client) — compact snippet python from apify_client import ApifyClient client = ApifyClient('<APIFY_TOKEN>') run_input = { "startUrls": ["https://www.facebook.com/reel/1234567890/"], "download": True, "desired_resolution": "1080p" } res = client.actor('<USERNAME>/<ACTOR_NAME>').call(run_input=run_input) print(res) --- ## 📝 Inputs (fields & schema) Console JSON input example (also saved as input.example.json): json { "startUrls": [ "https://www.facebook.com/reel/1234567890/" ], "download": true, "desired_resolution": "1080p", "preserve_downloads": false, "maxConcurrency": 5, "cookiesFile": "", "proxyConfiguration": { "useApifyProxy": true } } Aliases supported: startUrls, start_urls, startUrl, url. --- ## ⚙️ Configuration (Console inputs) | 🔑 Name | 📝 Type | ❓ Required | ⚙️ Default | 📌 Example | 🧠 Notes | | ------------------ | -------------: | :---------: | --------------------------- | --------------------------- | -------------------------------------------------- | | startUrls | array / string | ✅ Yes | None | ["https://.../reel/1234"] | List of Facebook Reel URLs (non-Reels are skipped) | | download | boolean | ⚙️ Optional | false | true | Enable storing video files to KV | | desired_resolution | string | ⚙️ Optional | 1080p | 720p, 1080p | Preferred max height for downloads | | preserve_downloads | boolean | ⚙️ Optional | false | true | Keep local copies after uploading to KV | | cookiesFile | string | ⚙️ Optional | "" | "/path/cookies.txt" | Use if a Reel requires session cookies | | proxyConfiguration | object | ⚙️ Optional | { "useApifyProxy": true } | { "useApifyProxy": true } | Apify Proxy or custom proxy settings | | maxConcurrency | integer | ⚙️ Optional | 5 | 10 | Parallel downloads (1–50 suggested) | Example Console setup: paste Reel URLs into startUrls and click Run. --- ## 📄 Outputs (Dataset / KV examples) The Actor pushes normalized JSON records to the Dataset and stores downloaded media in Key-Value store (KV). Example output record (Dataset) json [ { "platform": "facebook", "original_url": "https://web.facebook.com/reel/24958724177116560", "_source_index": 1, "_scraped_at": "2025-11-29T17:27:35.425245Z", "content_type": "reel", "is_reel": true, "webpage_url": "https://m.facebook.com/watch/?v=24958724177116560&_rdr", "id": "24958724177116560", "title": "জীবন কাটে অপেক্ষায় ; কখনো মানুষের, কখনো সু-দিনের।", "description": "জীবন কাটে অপেক্ষায় ;\nকখনো মানুষের, কখনো সু-দিনের।", "duration_seconds": 16.9, "duration": "16s", "upload_date_raw": "20251023", "upload_date": "23rd October 2025", "timestamp": 1761226676, "timestamp_iso": "2025-10-23T13:37:56Z", "view_count_raw": 401350, "view_count": "401.4K", "uploader": "Sabbir", "uploader_id": "100083467925822", "extractor": "facebook", "formats": [ { "format_id": "1931497271112816a", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "m4a", "tbr": 53.264, "asr": 44100, "format_note": "DASH audio", "container": "m4a_dash", "vcodec": "none", "acodec": "mp4a.40.5", "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQNcQS0u_5Zr5wvMr0jaiGn5x389t7xkQBm4IPFweqiXhltQnqbUvnp4wxl3kp4zODUZL1QdwoGZlSieMacGpAbkL-9uRRQx-X8mLj4.mp4?_nc_cat=101&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=rboF-NsGsGIQ7kNvwF04aKm&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoyNDk1ODcyNDE3NzExNjU2MCwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6MTE5MTQ5Mzk3OTQ4OTgwNSwiYXNzZXRfYWdlX2RheXMiOjM3LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTYsImJpdHJhdGUiOjUzNzE5LCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfhiDolk2aPmoo540DvoGOE-e4jAIW2gjk8b5tep2XACbA&oe=6930ED36", "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-GB,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": 53.264, "resolution": "audio only", "format": "1931497271112816a - audio only (DASH audio)" }, { "format_id": "sd", "quality": -3, "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQPyEk3z5OUgCzHwtjgnxEtq6IU9aKDnrzeltwxUNDKUgJhyRGJFy4ipSOkcm62TAkSnGFZz8Ov7Jwdr_flb5fAZiBMEP5PdHZrC13QL6A.mp4?_nc_cat=100&_nc_sid=8bf8fe&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=k6ruE-imCj4Q7kNvwFdvHOE&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjQwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTE5MTQ5Mzk3OTQ4OTgwNSwiYXNzZXRfYWdlX2RheXMiOjM3LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTYsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfgZicBc7RjgD21ubOM_8HuKRrp3yScMOFy7_k89TeJZHA&oe=6930F2E6&bitrate=401630&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-GB,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-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQOL125G2wYt1LdGJgL1KRY2ZpRyE5MNCrpWbQzXYWvZH6mmIqsUUS0oFhVL0zfUfq2FOdjpMhY1C2LQgHuR8gEWyAs1xIQF4l1zMxSTxJ8ANg.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=dIpO3-3deFYQ7kNvwFX8A3F&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI4MC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMTkxNDkzOTc5NDg5ODA1LCJhc3NldF9hZ2VfZGF5cyI6MzcsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoxNiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=f37a43e0c843d0a8&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC82ODRERjA1NkZCNEUzNkVDMkYyNUJFNjYwNThCRDM4OF9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzM5NDNERDI1MDkyRUNGNjBGQTE0QzVBNkFBMDU0QThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaamLL2ieqdBBUCKAJDMywXQDDmZmZmZmYYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfjJzn8U4200hobd4jl0PdgNXKGY-ELTcDZMG1csCeCxDg&oe=693100A2&bitrate=2972071&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-GB,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": "1113433463899774v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "mp4", "width": 640, "height": 360, "tbr": 344.407, "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/AQPqzkdNXWdk2hcGYBzclt6OM7KbaP1LjD5GQ943bHTTiEnF12tWOyVI1BxI1f-C4eAqG6kzvGxmzApySmtnQ8SzNzi17HrEG8R-SuLASaDERQ.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=FZ1LUjyhFNAQ7kNvwGfGU8D&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzM2MHAiLCJ2aWRlb19pZCI6MjQ5NTg3MjQxNzcxMTY1NjAsIm9pbF91cmxnZW5fYXBwX2lkIjowLCJjbGllbnRfbmFtZSI6InVua25vd24iLCJ4cHZfYXNzZXRfaWQiOjExOTE0OTM5Nzk0ODk4MDUsImFzc2V0X2FnZV9kYXlzIjozNywidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjE2LCJiaXRyYXRlIjozNDk0ODYsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ==&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfgiMK9vajGWyMaLA_CkamSLpXks3LfF4URdWAquhtkrWg&oe=6930E993", "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-GB,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": 344.407, "resolution": "640x360", "aspect_ratio": 1.78, "format": "1113433463899774v - 640x360 (DASH video)" }, { "format_id": "1112259230677298v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "mp4", "width": 1280, "height": 720, "tbr": 2985.359, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.64001f", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQOL125G2wYt1LdGJgL1KRY2ZpRyE5MNCrpWbQzXYWvZH6mmIqsUUS0oFhVL0zfUfq2FOdjpMhY1C2LQgHuR8gEWyAs1xIQF4l1zMxSTxJ8ANg.mp4?_nc_cat=106&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=dIpO3-3deFYQ7kNvwFX8A3F&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ2aWRlb19pZCI6MjQ5NTg3MjQxNzcxMTY1NjAsIm9pbF91cmxnZW5fYXBwX2lkIjowLCJjbGllbnRfbmFtZSI6InVua25vd24iLCJ4cHZfYXNzZXRfaWQiOjExOTE0OTM5Nzk0ODk4MDUsImFzc2V0X2FnZV9kYXlzIjozNywidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjE2LCJiaXRyYXRlIjoyOTE4MzUyLCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfhFgjiSeZ8dTJtitSSSZSzko5V3F2ecD15KFqSBxekO8Q&oe=693100A2", "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-GB,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": 2985.359, "resolution": "1280x720", "aspect_ratio": 1.78, "format": "1112259230677298v - 1280x720 (DASH video)" } ], "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/566247268_2354308174971659_1183967130451840814_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=50ce42&_nc_ohc=9Lv22u6mw8sQ7kNvwHXMHbe&_nc_oc=Adm1lNUXqGI2BLEdCCK_MMzMBQHfwugsb3QSh95Hjb86cO76xN8-sJhRazRxHcLEoCg&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&oh=00_Afi2ztMUH_aXZrqMqepcBRxDjcD_XYI9stLKKyivqtys1A&oe=6930F301", "thumbnails": [ { "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/566247268_2354308174971659_1183967130451840814_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=50ce42&_nc_ohc=9Lv22u6mw8sQ7kNvwHXMHbe&_nc_oc=Adm1lNUXqGI2BLEdCCK_MMzMBQHfwugsb3QSh95Hjb86cO76xN8-sJhRazRxHcLEoCg&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&oh=00_Afi2ztMUH_aXZrqMqepcBRxDjcD_XYI9stLKKyivqtys1A&oe=6930F301", "id": "0" } ], "raw_json": { "title": "জীবন কাটে অপেক্ষায় ; কখনো মানুষের, কখনো সু-দিনের।", "description": "জীবন কাটে অপেক্ষায় ;\nকখনো মানুষের, কখনো সু-দিনের।", "uploader": "Sabbir", "uploader_id": "100083467925822", "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/566247268_2354308174971659_1183967130451840814_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=50ce42&_nc_ohc=9Lv22u6mw8sQ7kNvwHXMHbe&_nc_oc=Adm1lNUXqGI2BLEdCCK_MMzMBQHfwugsb3QSh95Hjb86cO76xN8-sJhRazRxHcLEoCg&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&oh=00_Afi2ztMUH_aXZrqMqepcBRxDjcD_XYI9stLKKyivqtys1A&oe=6930F301", "view_count": 401350, "concurrent_view_count": 0, "duration": 16.9, "id": "24958724177116560", "formats": [ { "format_id": "1931497271112816a", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "m4a", "tbr": 53.264, "asr": 44100, "format_note": "DASH audio", "container": "m4a_dash", "vcodec": "none", "acodec": "mp4a.40.5", "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQNcQS0u_5Zr5wvMr0jaiGn5x389t7xkQBm4IPFweqiXhltQnqbUvnp4wxl3kp4zODUZL1QdwoGZlSieMacGpAbkL-9uRRQx-X8mLj4.mp4?_nc_cat=101&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=rboF-NsGsGIQ7kNvwF04aKm&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoyNDk1ODcyNDE3NzExNjU2MCwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6MTE5MTQ5Mzk3OTQ4OTgwNSwiYXNzZXRfYWdlX2RheXMiOjM3LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTYsImJpdHJhdGUiOjUzNzE5LCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfhiDolk2aPmoo540DvoGOE-e4jAIW2gjk8b5tep2XACbA&oe=6930ED36", "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-GB,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": 53.264, "resolution": "audio only", "format": "1931497271112816a - audio only (DASH audio)" }, { "format_id": "sd", "quality": -3, "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQPyEk3z5OUgCzHwtjgnxEtq6IU9aKDnrzeltwxUNDKUgJhyRGJFy4ipSOkcm62TAkSnGFZz8Ov7Jwdr_flb5fAZiBMEP5PdHZrC13QL6A.mp4?_nc_cat=100&_nc_sid=8bf8fe&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=k6ruE-imCj4Q7kNvwFdvHOE&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNjQwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTE5MTQ5Mzk3OTQ4OTgwNSwiYXNzZXRfYWdlX2RheXMiOjM3LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTYsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfgZicBc7RjgD21ubOM_8HuKRrp3yScMOFy7_k89TeJZHA&oe=6930F2E6&bitrate=401630&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-GB,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-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQOL125G2wYt1LdGJgL1KRY2ZpRyE5MNCrpWbQzXYWvZH6mmIqsUUS0oFhVL0zfUfq2FOdjpMhY1C2LQgHuR8gEWyAs1xIQF4l1zMxSTxJ8ANg.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=dIpO3-3deFYQ7kNvwFX8A3F&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMTI4MC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMTkxNDkzOTc5NDg5ODA1LCJhc3NldF9hZ2VfZGF5cyI6MzcsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjoxNiwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=f37a43e0c843d0a8&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC82ODRERjA1NkZCNEUzNkVDMkYyNUJFNjYwNThCRDM4OF9tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzM5NDNERDI1MDkyRUNGNjBGQTE0QzVBNkFBMDU0QThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaamLL2ieqdBBUCKAJDMywXQDDmZmZmZmYYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCZZSeAQA&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfjJzn8U4200hobd4jl0PdgNXKGY-ELTcDZMG1csCeCxDg&oe=693100A2&bitrate=2972071&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-GB,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": "1113433463899774v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "mp4", "width": 640, "height": 360, "tbr": 344.407, "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/AQPqzkdNXWdk2hcGYBzclt6OM7KbaP1LjD5GQ943bHTTiEnF12tWOyVI1BxI1f-C4eAqG6kzvGxmzApySmtnQ8SzNzi17HrEG8R-SuLASaDERQ.mp4?_nc_cat=105&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=FZ1LUjyhFNAQ7kNvwGfGU8D&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzM2MHAiLCJ2aWRlb19pZCI6MjQ5NTg3MjQxNzcxMTY1NjAsIm9pbF91cmxnZW5fYXBwX2lkIjowLCJjbGllbnRfbmFtZSI6InVua25vd24iLCJ4cHZfYXNzZXRfaWQiOjExOTE0OTM5Nzk0ODk4MDUsImFzc2V0X2FnZV9kYXlzIjozNywidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjE2LCJiaXRyYXRlIjozNDk0ODYsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ==&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfgiMK9vajGWyMaLA_CkamSLpXks3LfF4URdWAquhtkrWg&oe=6930E993", "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-GB,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": 344.407, "resolution": "640x360", "aspect_ratio": 1.78, "format": "1113433463899774v - 640x360 (DASH video)" }, { "format_id": "1112259230677298v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "mp4", "width": 1280, "height": 720, "tbr": 2985.359, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.64001f", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQOL125G2wYt1LdGJgL1KRY2ZpRyE5MNCrpWbQzXYWvZH6mmIqsUUS0oFhVL0zfUfq2FOdjpMhY1C2LQgHuR8gEWyAs1xIQF4l1zMxSTxJ8ANg.mp4?_nc_cat=106&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=dIpO3-3deFYQ7kNvwFX8A3F&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ2aWRlb19pZCI6MjQ5NTg3MjQxNzcxMTY1NjAsIm9pbF91cmxnZW5fYXBwX2lkIjowLCJjbGllbnRfbmFtZSI6InVua25vd24iLCJ4cHZfYXNzZXRfaWQiOjExOTE0OTM5Nzk0ODk4MDUsImFzc2V0X2FnZV9kYXlzIjozNywidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjE2LCJiaXRyYXRlIjoyOTE4MzUyLCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfhFgjiSeZ8dTJtitSSSZSzko5V3F2ecD15KFqSBxekO8Q&oe=693100A2", "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-GB,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": 2985.359, "resolution": "1280x720", "aspect_ratio": 1.78, "format": "1112259230677298v - 1280x720 (DASH video)" } ], "timestamp": 1761226676, "automatic_captions": {}, "subtitles": {}, "original_url": "https://web.facebook.com/reel/24958724177116560", "webpage_url": "https://m.facebook.com/watch/?v=24958724177116560&_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/566247268_2354308174971659_1183967130451840814_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=50ce42&_nc_ohc=9Lv22u6mw8sQ7kNvwHXMHbe&_nc_oc=Adm1lNUXqGI2BLEdCCK_MMzMBQHfwugsb3QSh95Hjb86cO76xN8-sJhRazRxHcLEoCg&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&oh=00_Afi2ztMUH_aXZrqMqepcBRxDjcD_XYI9stLKKyivqtys1A&oe=6930F301", "id": "0" } ], "display_id": "24958724177116560", "fulltitle": "জীবন কাটে অপেক্ষায় ; কখনো মানুষের, কখনো সু-দিনের।", "duration_string": "16", "upload_date": "20251023", "epoch": 1764437257, "requested_formats": [ { "format_id": "1112259230677298v", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "mp4", "width": 1280, "height": 720, "tbr": 2985.359, "format_note": "DASH video", "container": "mp4_dash", "vcodec": "avc1.64001f", "acodec": "none", "dynamic_range": "SDR", "url": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m366/AQOL125G2wYt1LdGJgL1KRY2ZpRyE5MNCrpWbQzXYWvZH6mmIqsUUS0oFhVL0zfUfq2FOdjpMhY1C2LQgHuR8gEWyAs1xIQF4l1zMxSTxJ8ANg.mp4?_nc_cat=106&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=dIpO3-3deFYQ7kNvwFX8A3F&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ2aWRlb19pZCI6MjQ5NTg3MjQxNzcxMTY1NjAsIm9pbF91cmxnZW5fYXBwX2lkIjowLCJjbGllbnRfbmFtZSI6InVua25vd24iLCJ4cHZfYXNzZXRfaWQiOjExOTE0OTM5Nzk0ODk4MDUsImFzc2V0X2FnZV9kYXlzIjozNywidmlfdXNlY2FzZV9pZCI6MTAxMjIsImR1cmF0aW9uX3MiOjE2LCJiaXRyYXRlIjoyOTE4MzUyLCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfhFgjiSeZ8dTJtitSSSZSzko5V3F2ecD15KFqSBxekO8Q&oe=693100A2", "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-GB,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": 2985.359, "resolution": "1280x720", "aspect_ratio": 1.78, "format": "1112259230677298v - 1280x720 (DASH video)" }, { "format_id": "1931497271112816a", "manifest_url": "https://www.facebook.com/dash_mpd_debug.mpd?v=24958724177116560&dummy=.mpd", "ext": "m4a", "tbr": 53.264, "asr": 44100, "format_note": "DASH audio", "container": "m4a_dash", "vcodec": "none", "acodec": "mp4a.40.5", "url": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQNcQS0u_5Zr5wvMr0jaiGn5x389t7xkQBm4IPFweqiXhltQnqbUvnp4wxl3kp4zODUZL1QdwoGZlSieMacGpAbkL-9uRRQx-X8mLj4.mp4?_nc_cat=101&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=rboF-NsGsGIQ7kNvwF04aKm&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoyNDk1ODcyNDE3NzExNjU2MCwib2lsX3VybGdlbl9hcHBfaWQiOjAsImNsaWVudF9uYW1lIjoidW5rbm93biIsInhwdl9hc3NldF9pZCI6MTE5MTQ5Mzk3OTQ4OTgwNSwiYXNzZXRfYWdlX2RheXMiOjM3LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTYsImJpdHJhdGUiOjUzNzE5LCJ1cmxnZW5fc291cmNlIjoid3d3In0=&ccb=17-1&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&_nc_zt=28&oh=00_AfhiDolk2aPmoo540DvoGOE-e4jAIW2gjk8b5tep2XACbA&oe=6930ED36", "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-GB,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": 53.264, "resolution": "audio only", "format": "1931497271112816a - audio only (DASH audio)" } ], "format": "1112259230677298v - 1280x720 (DASH video)+1931497271112816a - audio only (DASH audio)", "format_id": "1112259230677298v+1931497271112816a", "ext": "mp4", "protocol": "https+https", "format_note": "DASH video+DASH audio", "tbr": 3038.623, "width": 1280, "height": 720, "resolution": "1280x720", "dynamic_range": "SDR", "vcodec": "avc1.64001f", "vbr": 2985.359, "aspect_ratio": 1.78, "acodec": "mp4a.40.5", "abr": 53.264, "asr": 44100 }, "yt_info": { "id": "24958724177116560", "title": "জীবন কাটে অপেক্ষায় ; কখনো মানুষের, কখনো সু-দিনের।", "duration": 16.9, "thumbnail": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/566247268_2354308174971659_1183967130451840814_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=50ce42&_nc_ohc=9Lv22u6mw8sQ7kNvwHXMHbe&_nc_oc=Adm1lNUXqGI2BLEdCCK_MMzMBQHfwugsb3QSh95Hjb86cO76xN8-sJhRazRxHcLEoCg&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=e7cFbnJZ3LIhv__NhaGNAA&oh=00_Afi2ztMUH_aXZrqMqepcBRxDjcD_XYI9stLKKyivqtys1A&oe=6930F301" }, "kv_files": { "final": { "kv_key": "MEDIA_24958724177116560_final.mp4", "local": "/app/output/MEDIA_24958724177116560_final.mp4" } }, "download_links": { "final_kv": "MEDIA_24958724177116560_final.mp4", "final_local": "/app/output/MEDIA_24958724177116560_final.mp4", "final_direct_url": "https://api.apify.com/v2/key-value-stores/~/records/MEDIA_24958724177116560_final.mp4" } } ] Where to find files * Dataset: Apify Console → Storage → Datasets (select this run) * Downloaded videos: Apify Console → Storage → Key-value store → record <kv_key> --- ## 🔑 Environment Variables / Secrets * <APIFY_TOKEN> — Apify API token (store as Console secret) * <PROXY_USER:PASS@HOST:PORT> — custom proxy (use only when not using Apify Proxy) > ⚠️ Always store tokens and proxy credentials as secrets; do NOT include credentials in startUrls or public inputs. --- ## ▶️ How to Run (detailed) Apify Console 1. Open the Actor page in Apify Console. 2. Paste input.example.json or fill the Input editor. 3. Click Run. Monitor 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: use the Schedule tab in Console to run hourly/daily. * Webhooks: configure run-complete webhooks to trigger downstream workflows or to receive Dataset/KV links. --- ## 🕾️ Logs & Troubleshooting * View Logs: run → Logs in Apify Console. * Common issues & fixes: * No Reel URLs provided — add valid Facebook Reel links to startUrls. * Skipping non-Reel URLs — check logs; non-Reel URLs are intentionally ignored. * Download failed — enable proxyConfiguration or provide cookiesFile if needed. * Large runs — lower maxConcurrency or enable proxy rotation in CONFIG.md. --- ## 🔒 Permissions & Storage Notes * Storage: Dataset for structured JSON; Key-Value store for media files. * Privacy & safety: This Actor processes public Reels only. Do not use it to access private content or circumvent access controls. Designed to be secure by default. --- ## 🔟 Changelog / Versioning * v1.0.1 — Reel-only release: enforces Reels filtering, normalized outputs, H.264-first downloads, KV storage. --- ## 🖌 Notes / TODOs * TODO: confirm output schema — some fields inferred from runtime normalization. * TODO: add demo GIF/screenshots to boost conversions and clarity. --- ## 🌍 Proxy Configuration Quick: Enable Apify Proxy in Console (proxyConfiguration.useApifyProxy: true) for reliable downloads. Custom proxy example (use secrets): * HTTP_PROXY / HTTPS_PROXY env vars: http://<PROXY_USER:PASS@HOST:PORT> * Input example: {"useApifyProxy": false, "proxyUrls": ["http://<PROXY_USER:PASS@HOST:PORT>"]} Security notes: * Store proxy credentials as secrets in Console. * TODO: Consider proxy rotation for large-scale scraping. --- ## 📚 References * Apify Actor README guidelines: https://docs.apify.com/actors/README * Input/Output patterns: https://docs.apify.com/actors/input-output * apify-cli & apify-client: https://docs.apify.com/tools --- ## 🤔 What I inferred from main.py * This Actor only processes Facebook Reels; non-Reel URLs are filtered and skipped. * It extracts metadata and performs record normalization (content_type:is_reel, timestamps, views, etc.). * Downloads prefer H.264 (AVC); files are uploaded to Key-Value store and Dataset receives JSON records. * Supports cookies, Apify Proxy (or custom proxies), and configurable concurrency. * Skips non-Reel URLs early and logs skipped items for transparency. --- ## ✅ Why this Actor Instant insights, secure-by-design, and production-ready — collect normalized Reel data and media with zero setup. Run this Actor on Apify Console — get results in seconds. --- ## input.example.json (file contents) json { "startUrls": [ "https://www.facebook.com/reel/1234567890/" ], "download": true, "desired_resolution": "1080p", "preserve_downloads": false, "maxConcurrency": 5, "cookiesFile": "", "proxyConfiguration": { "useApifyProxy": true } } --- ## CONFIG.md (developer-facing guidance) * Purpose: Explain advanced proxy rotation, concurrency tuning, and cookies usage. * Proxy rotation: for large-scale runs, use a proxy pool and rotate proxyUrls to avoid rate limits. * Concurrency tips: start with maxConcurrency: 5 and increase gradually; monitor CPU and network. * Cookies: if a Reel requires a logged-in session, provide a cookiesFile path (store as secret). * Storage: downloaded media saved to KV keys named like MEDIA_<ID>_final.mp4. * Safety: do not attempt to scrape private or paywalled content