Facebook Video Scraper with Downloder pro avatar
Facebook Video Scraper with Downloder pro

Pricing

$8.99/month + usage

Go to Apify Store
Facebook Video Scraper with Downloder pro

Facebook Video Scraper with Downloder pro

This powerful Facebook Video Scraper with Downloader Pro lets you capture public Facebook videos at scale—complete with titles, views, timestamps, and rich metadata. Designed for those who need fast, precise, high-quality video data to gain an information edge. Try once and get addicted forever.

Pricing

$8.99/month + usage

Rating

0.0

(0)

Developer

Neuro Scraper

Neuro Scraper

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Share

🌟 Facebook Video Scraper & Downloader

build-badge version license trusted

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)

Console demo GIF

  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)

$apify run --actor <USERNAME>/<ACTOR_NAME> --input input.example.json

Python (apify-client) — one snippet

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):

{
"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
startUrlsarray / string✅ YesNone["https://...watch?v=123"]Primary list of public video URLs
downloadboolean⚙️ OptionalfalsetrueWhether to download video files
desired_resolutionstring⚙️ Optional1080p720p, 1080pMax height to prefer for downloads
preserve_downloadsboolean⚙️ OptionalfalsetrueKeep local files after storing to KV
cookiesFilestring⚙️ Optional"""/path/cookies.txt"Path to cookies file if needed
proxyConfigurationobject⚙️ Optional{ useApifyProxy: true }{ "useApifyProxy": true }Apify Proxy or custom proxy settings
maxConcurrencyinteger⚙️ Optional510Controls 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)

[
{
"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 → StorageDatasets (this run)
  • Downloaded videos: Apify Console → StorageKey-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

$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


🤔 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.