---

🎯 Facebook Thumbnail Downloader Video & Reels

Scrape Facebook videos and reels effortlessly! Extract video metadata, select preferred thumbnail resolution, get all available thumbnails, and view video quality, format, and file info. Perfect for marketers, researchers, and media projects.

---

🌟 Overview

The Facebook Video/Reel Scraper Actor allows you to extract metadata, thumbnail URLs, video quality, and format details from Facebook videos and reels with ease. Whether you have standard Facebook video URLs or share links, this actor can process them all and provide a clean, structured dataset.

This is perfect for marketers, content managers, researchers, or developers who need detailed metadata of Facebook videos for analysis, cataloging, or media projects.

---

📝 Features

• Supports both Facebook video and reel URLs (standard URLs & share links).
• Choose preferred thumbnail resolution: 130px, 480px, 720px, or Full size.
• Automatically selects the best matching thumbnail based on your preferred resolution.
• Extracts all available thumbnails for a video along with width and height.
• Provides video quality information including HD/SD, resolution, format ID, and notes.
• Returns file extension for the video.
• Handles errors gracefully and logs detailed information for troubleshooting.
• Pushes results to a dataset automatically.

---

🎯 Benefits and Advantages

• Saves Time: Scrape multiple Facebook video URLs at once without manual downloading.
• Customizable Output: Select thumbnail resolution to match your project requirements.
• Detailed Metadata: Get all video quality information for analysis or cataloging.
• Error Handling: Even if some videos fail, you get detailed error messages for debugging.
• Easy to Use: Simple input, straightforward output, and clear logs.

---

📂 Input Schema

1. Thumbnail Resolution 🖼️

• Field: thumbnail_resolution

• Type: String (select)

• Description: Choose your preferred resolution for the thumbnail.

• Options:

  • 130px
  • 480px
  • 720px
  • Full size

• Default: Full size

2. Facebook Video/Post URLs 🟢

• Field: post_urls
• Type: Array
• Description: List of Facebook video or post URLs. Supports standard URLs and share links.

Example:

[
  { "url": "https://web.facebook.com/watch/?v=783325287492075" },
  { "url": "https://www.facebook.com/share/v/19rwZLYMnG/" }
]

3. Facebook Reel URLs 🔵

• Field: reel_urls
• Type: Array
• Description: List of Facebook reel URLs. Supports standard URLs and share links.

Example:

[
  { "url": "https://web.facebook.com/reel/1831270064408357" },
  { "url": "https://www.facebook.com/share/v/1J6aQBAaAd/" }
]

⚠️ Note: You can provide URLs in either post_urls or reel_urls or both. The actor will process all provided URLs.

---

🖥️ Output Schema

For each URL, the actor generates the following structured output:

Field	Description
source url / link	The original Facebook video or reel URL you provided.
selected thumbnail_url	The thumbnail URL that best matches your preferred resolution.
format_id	Human-readable video quality including HD/SD classification, resolution, and format note.
ext	File extension (e.g., mp4).
all thumbnails	Array of all available thumbnails for the video with width and height.
error (optional)	Detailed error message if scraping fails.

Example Output:

{
  "source url / link": "https://web.facebook.com/watch/?v=783325287492075",
  "selected thumbnail_url": "https://scontent.fbcdn.net/v/t39.24130-6/123456789_1012345678_n.jpg",
  "format_id": "hd - 1280x720 - format:137",
  "ext": "mp4",
  "all thumbnails": [
    { "url": "https://scontent.fbcdn.net/v/t39.24130-6/123456789_1012345678_n.jpg", 
    "width": 720,
     "height": 1280 },
    { "url": "https://scontent.fbcdn.net/v/t39.24130-6/987654321_1012345678_n.jpg", 
    "width": 480, 
    "height": 854 }
  ]
}

---

🔧 How It Works (User-Friendly)

1. Paste your Facebook video or reel URLs in the actor input.

2. Choose a thumbnail resolution from the dropdown menu.

3. Run the actor.

4. The actor will:

   • Fetch all video/reel metadata.
   • Extract all available thumbnails and select the one that best matches your preferred resolution.
   • Determine video quality and format.
   • Save results in a structured dataset.

✅ No coding is required. Just provide URLs and the actor does the rest.

---

🧪 Input & Output Example

Input Example:

{
    "post_urls": [
        {
            "url": "https://web.facebook.com/watch/?v=783325287492075"
        },
        {
            "url": "https://www.facebook.com/share/r/1FPB5LtKdD/"
        }
    ],

    "reel_urls": [
        {
            "url": "https://web.facebook.com/reel/1831270064408357"
        },
        {
            "url": "https://www.facebook.com/share/v/1J6aQBAaAd/"
        }
    ],

    "thumbnail_resolution": "Full size"
}

Output Example:

[
  {
    "source url / link": "https://web.facebook.com/watch/?v=783325287492075",
    "selected thumbnail_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/536625016_1422113702239824_8997957425835878271_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=be8305&_nc_ohc=xHVAFLUmzhYQ7kNvwGWdkJg&_nc_oc=Adnfsv1bIMcObTH-t5FaTxiq7z9Pjk-kQR1giRfwvC6Js-Z9pPOD3bpvG5MHtiYfT3w&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=d3_6kgsfbJv3coNJjVs9mQ&oh=00_AfoYMTale6DFwic4PPNJINhgnjxT5nxsUIy7Ua0q9mef6A&oe=69619308",
    "format_id": "format:hd",
    "ext": "mp4",
    "all thumbnails": [
      {
        "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/536625016_1422113702239824_8997957425835878271_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=109&ccb=1-7&_nc_sid=be8305&_nc_ohc=xHVAFLUmzhYQ7kNvwGWdkJg&_nc_oc=Adnfsv1bIMcObTH-t5FaTxiq7z9Pjk-kQR1giRfwvC6Js-Z9pPOD3bpvG5MHtiYfT3w&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=d3_6kgsfbJv3coNJjVs9mQ&oh=00_AfoYMTale6DFwic4PPNJINhgnjxT5nxsUIy7Ua0q9mef6A&oe=69619308",
        "width": "",
        "height": ""
      }
    ]
  },
  {
    "source url / link": "https://www.facebook.com/share/r/1FPB5LtKdD/",
    "selected thumbnail_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.71878-10/580925915_2222156534951111_2433263775422941820_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=50ce42&_nc_ohc=SIfRuQjsaSsQ7kNvwH1j3Yx&_nc_oc=AdkiSQZrdnHLexfgzXdUq3Lvt9xDuYhgmgJmWuCCrPAxjY6veiFjbn3zvGsBwfpbqok&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=arZM_qFDOJZTvqS-ok6C1Q&oh=00_AfqR2PhM7nJ3k_Yw1ryfz_jnX-2OU2hzWwUIWiCMV7f0pw&oe=69619B4E",
    "format_id": "format:hd",
    "ext": "mp4",
    "all thumbnails": [
      {
        "url": "https://scontent-iad3-2.xx.fbcdn.net/v/t51.71878-10/580925915_2222156534951111_2433263775422941820_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=50ce42&_nc_ohc=SIfRuQjsaSsQ7kNvwH1j3Yx&_nc_oc=AdkiSQZrdnHLexfgzXdUq3Lvt9xDuYhgmgJmWuCCrPAxjY6veiFjbn3zvGsBwfpbqok&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=arZM_qFDOJZTvqS-ok6C1Q&oh=00_AfqR2PhM7nJ3k_Yw1ryfz_jnX-2OU2hzWwUIWiCMV7f0pw&oe=69619B4E",
        "width": "",
        "height": ""
      }
    ]
  },
  {
    "source url / link": "https://web.facebook.com/reel/1831270064408357",
    "selected thumbnail_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/529773654_1307743380784400_2091905933132907197_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=110&ccb=1-7&_nc_sid=50ce42&_nc_ohc=P725RggRQxwQ7kNvwGBHGya&_nc_oc=AdmeCy1MjUeTydoQdNC5yb_hjCvY8NrVfGmKGpdhS6gE5t34HOpr0Kd7rKj1TWWrxcY&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=fDtC9_kL6RoHwD9X1TqsOw&oh=00_AfrirwmIGmcb73fN8YZ11ZvkEYaeF4003y8ImuKTke27WQ&oe=6961895C",
    "format_id": "format:hd",
    "ext": "mp4",
    "all thumbnails": [
      {
        "url": "https://scontent-iad3-1.xx.fbcdn.net/v/t15.5256-10/529773654_1307743380784400_2091905933132907197_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=110&ccb=1-7&_nc_sid=50ce42&_nc_ohc=P725RggRQxwQ7kNvwGBHGya&_nc_oc=AdmeCy1MjUeTydoQdNC5yb_hjCvY8NrVfGmKGpdhS6gE5t34HOpr0Kd7rKj1TWWrxcY&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=fDtC9_kL6RoHwD9X1TqsOw&oh=00_AfrirwmIGmcb73fN8YZ11ZvkEYaeF4003y8ImuKTke27WQ&oe=6961895C",
        "width": "",
        "height": ""
      }
    ]
  },
  {
    "source url / link": "https://www.facebook.com/share/v/1J6aQBAaAd/",
    "selected thumbnail_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/605427236_2021863158604349_6788215007003440390_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=100&ccb=1-7&_nc_sid=be8305&_nc_ohc=MEgWldVCQTcQ7kNvwHHCxFM&_nc_oc=AdmEedydcU2pkl90X9j8VwNSmYk79WuzCQzjyd3XYMKdEUhUtWPV8wtE_mwathVXy8g&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=qsni2dWbJEpVGYHu8GlRkg&oh=00_Afop1fo-tzIQBYFoJqxv33yiW7D1Zr811NeCoDcUzXSSUQ&oe=6961859A",
    "format_id": "format:hd",
    "ext": "mp4",
    "all thumbnails": [
      {
        "url": "https://scontent-iad3-2.xx.fbcdn.net/v/t15.5256-10/605427236_2021863158604349_6788215007003440390_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=100&ccb=1-7&_nc_sid=be8305&_nc_ohc=MEgWldVCQTcQ7kNvwHHCxFM&_nc_oc=AdmEedydcU2pkl90X9j8VwNSmYk79WuzCQzjyd3XYMKdEUhUtWPV8wtE_mwathVXy8g&_nc_zt=23&_nc_ht=scontent-iad3-2.xx&_nc_gid=qsni2dWbJEpVGYHu8GlRkg&oh=00_Afop1fo-tzIQBYFoJqxv33yiW7D1Zr811NeCoDcUzXSSUQ&oe=6961859A",
        "width": "",
        "height": ""
      }
    ]
  }
]

---

✅ Best Practices

• Always verify that URLs are publicly accessible. Private videos will not be processed.
• If you encounter incomplete data, rerun the actor. This often resolves temporary network or access issues.
• Use the Full size thumbnail option if you need the highest quality image.
• Keep the list of URLs reasonable in size per run to avoid hitting rate limits.

---

⚠️ Possible Errors and How to Handle Them

Error	Meaning	Solution
No URLs provided	The input did not contain any post_urls or reel_urls	Add valid Facebook video or reel URLs.
URL not accessible	Video is private, removed, or blocked in your region	Verify URL accessibility or use public videos.
Error in format extraction	Video metadata could not be fully retrieved	Rerun the actor; check the URL.
Selected thumbnail empty	No matching thumbnail found	Try using "Full size" as resolution.

---

💌 Contact Support

If you encounter issues or unexpected results, contact: alphascraper69@gmail.com

---

🌈 Summary

The Facebook Video/Reel Scraper Actor is an easy-to-use tool that:

• Processes multiple video and reel URLs at once.
• Extracts high-quality thumbnails and all available metadata.
• Provides human-readable video quality info.
• Handles errors gracefully and maintains logs for debugging.

With this actor, you can streamline video metadata collection for research, media projects, or marketing campaigns.

---