# Facebook Thumbnail Downloader (`codenest/facebook-thumbnail-downloader`) Actor Extract high-quality Facebook thumbnails for Reels and Videos with direct CDN access. This professional tool delivers multiple thumbnail variants, view count analytics, format specifications, and normalized URLs for reliable media asset acquisition. ❤️Facebook Thumbnail Downloader(Reels & Video). - **URL**: https://apify.com/codenest/facebook-thumbnail-downloader.md - **Developed by:** [CodeNest](https://apify.com/codenest) (community) - **Categories:** Social media, Videos, Developer tools - **Stats:** 9 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $4.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Facebook Thumbnail Downloader - Professional Thumbnail Extraction Tool **🚀 Effortlessly download high-quality Facebook thumbnails with our enterprise-grade Facebook Thumbnail Downloader! This Apify actor enables you to extract thumbnails from Facebook videos, Reels, and posts while preserving image quality and providing comprehensive metadata.** --- ### 📖 Overview Need to archive Facebook content thumbnails or analyze visual content? This **Facebook Thumbnail Downloader** delivers: - **Multiple thumbnail formats**: HD quality images - **Batch processing**: Handle multiple URLs simultaneously - **Full metadata**: URLs, format IDs, and file extensions - **Direct CDN access**: Get original Facebook thumbnail URLs Perfect for social media managers 📊, content creators 🎨, and digital marketers 📱! ### ⭐ Core Capabilities/Key Features #### 🖼️ Thumbnail Options - **Multiple Resolutions**: Access various thumbnail qualities - **Batch Download**: Process multiple Facebook URLs per run - **Format Support**: JPEG, PNG, and other image formats - **Direct URLs**: Get direct CDN links for immediate use #### 🔍 Metadata Extraction - **Source URLs**: Original Facebook post and Reel links - **Format Identification**: HD and other quality identifiers - **File Extensions**: Container format information - **View Counts**: Engagement metrics for videos #### 🛠️ Advanced Tech - **URL Validation**: Smart Facebook URL detection - **Quality Fallback**: Auto-select best available thumbnails - **Bulk Processing**: Efficient handling of multiple requests - **Error Handling**: Comprehensive validation and recovery --- ### ⌨️ Input Configuration Just enter your Facebook video or Reel URLs in the Input Section then click the "start" button and wait for the thumbnails. The **Facebook Thumbnail Downloader** supports both post videos and Reels: ```json { "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" } ], "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357" } ] } ```` #### 📋 Input Specifications | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `post_urls` | Array | No | Facebook video post URLs to process | | `reel_urls` | Array | No | Facebook Reel URLs to process | | `url` | String | Yes | Valid Facebook video or Reel URL | *** ### 📊 Output Structure The **Facebook Thumbnail Downloader** provides comprehensive output with multiple thumbnail options: ```json [ { "url": "https://www.facebook.com/reel/1831270064408357/", "thumbnail_url": "https://scontent-ord5-3.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=-9ARU6r_lW0Q7kNvwEo-xsO&_nc_oc=AdkcHvVTYM5eYqvHS-vrjYWShtVwwZv1h9QweGjiB9uQfEGugnNZ7sGE0Gekd68rL-8z96B3NwHuzYmZHwHhji_G&_nc_zt=23&_nc_ht=scontent-ord5-3.xx&_nc_gid=-SjeyF6Tm6GJSpadmcdp3Q&oh=00_Afi-Bp4yf5yfwYAsyryUM1LXSI6nSfDCcdrzcsHLNa07Xw&oe=691D339C", "format_id": "hd", "ext": "mp4", "thumbnails": [ { "url": "https://scontent-ord5-3.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=-9ARU6r_lW0Q7kNvwEo-xsO&_nc_oc=AdkcHvVTYM5eYqvHS-vrjYWShtVwwZv1h9QweGjiB9uQfEGugnNZ7sGE0Gekd68rL-8z96B3NwHuzYmZHwHhji_G&_nc_zt=23&_nc_ht=scontent-ord5-3.xx&_nc_gid=-SjeyF6Tm6GJSpadmcdp3Q&oh=00_Afi-Bp4yf5yfwYAsyryUM1LXSI6nSfDCcdrzcsHLNa07Xw&oe=691D339C" } ] } ] ``` #### 📝 Output Field Documentation **Metadata Section** | Field | Description | |-------|-------------| | `url` | Original Facebook video or Reel URL | | `thumbnail_url` | Primary thumbnail download URL | | `format_id` | Quality identifier (hd, sd, etc.) | | `ext` | Container format (jpg, png, etc.) | | `view_count` | Video view count (when available) | **Thumbnail Assets** | Field | Description | |-------|-------------| | `thumbnails` | Array of available thumbnail URLs | | `url` | Individual thumbnail CDN URL | *** ### 🎯 Quality Tiers Available This **Facebook Thumbnail Downloader** automatically detects and provides multiple thumbnail quality options: 1. **High Definition** - 960x960 and higher resolutions 2. **Standard Definition** - Various intermediate resolutions 3. **Optimized Formats** - Web-optimized image compression Each quality tier includes direct CDN access for maximum reliability. *** ### 🔧 Technical Features #### 🖼️ Advanced Thumbnail Support - Multiple resolution extraction - Direct CDN URL access - Batch processing capabilities - Format detection and validation #### 📈 Metadata Extraction - Source URL preservation - Quality tier identification - View count metrics (when available) - File format specifications #### ⚡ Reliability Features - Direct Facebook CDN access - Multiple thumbnail fallback options - Comprehensive error handling - URL validation and normalization *** ### 💼 Use Cases - **Content Creators** – Archive thumbnail variations for analysis - **Social Media Managers** – Extract thumbnails for reports and presentations - **Digital Marketers** – Analyze competitor thumbnail strategies - **Researchers** – Study visual content trends and patterns - **App Developers** – Build thumbnail-powered applications *** #### 🌟 Why Choose Our Facebook Thumbnail Downloader? - **Reliable Performance**: Stable and efficient thumbnail extraction process - **User-Friendly**: Simple interface for both beginners and advanced users - **Regular Updates**: Maintained to ensure compatibility with Facebook changes - **Comprehensive Data**: Get all thumbnail variations in one place - **Batch Processing**: Handle multiple URLs simultaneously with our **Facebook Thumbnail Downloader** *** #### ⚠️ Limitations - Only works with public Facebook videos and Reels - Thumbnail availability depends on Facebook's CDN - The actor may hit rate limits depending on Facebook's restrictions ### 🔗🛠 Related Actors (Full Content Scraping Suite) Explore our full scraping suite for enhanced social media scraping: #### 📹 Facebook Scrapers: - [Facebook Video Downloader](https://apify.com/codenest/facebook-video-downloader) - [Facebook Reels Downloader](https://apify.com/codenest/facebook-reels-downloader) #### 🎥 YouTube Scrapers: - [YouTube Video Scraper](https://apify.com/codenest/youtube-video-scraper) - [YouTube Video Transcript Scraper](https://apify.com/codenest/youtube-video-transcript-scraper) *** ### 📧 Need Customization? Want \*higher resolution thumbnails, \*\*batch downloads, or \**enhanced metadata* for your **Facebook Thumbnail Downloader**? ✉ Email ** for tailored solutions! *** *The **Facebook Thumbnail Downloader** is your go-to solution for efficient Facebook thumbnail extraction with professional-grade reliability and comprehensive metadata coverage.* # Actor input Schema ## `reel_urls` (type: `array`): List of public Facebook Reels URLs. Also supports fb.watch and will resolve share/v links. ## `post_urls` (type: `array`): List of public Facebook video post URLs. ## Actor input object example ```json { "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357" } ], "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" } ] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357" } ], "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("codenest/facebook-thumbnail-downloader").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "reel_urls": [{ "url": "https://web.facebook.com/reel/1831270064408357" }], "post_urls": [{ "url": "https://web.facebook.com/watch/?v=783325287492075" }], } # Run the Actor and wait for it to finish run = client.actor("codenest/facebook-thumbnail-downloader").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "reel_urls": [ { "url": "https://web.facebook.com/reel/1831270064408357" } ], "post_urls": [ { "url": "https://web.facebook.com/watch/?v=783325287492075" } ] }' | apify call codenest/facebook-thumbnail-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=codenest/facebook-thumbnail-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Thumbnail Downloader", "description": "Extract high-quality Facebook thumbnails for Reels and Videos with direct CDN access. This professional tool delivers multiple thumbnail variants, view count analytics, format specifications, and normalized URLs for reliable media asset acquisition. ❤️Facebook Thumbnail Downloader(Reels & Video).", "version": "0.0", "x-build-id": "eIXu6MyAwOnkqglWL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codenest~facebook-thumbnail-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codenest-facebook-thumbnail-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/codenest~facebook-thumbnail-downloader/runs": { "post": { "operationId": "runs-sync-codenest-facebook-thumbnail-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/codenest~facebook-thumbnail-downloader/run-sync": { "post": { "operationId": "run-sync-codenest-facebook-thumbnail-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "reel_urls": { "title": "Facebook Reels URLs", "type": "array", "description": "List of public Facebook Reels URLs. Also supports fb.watch and will resolve share/v links.", "items": { "type": "object", "properties": { "url": { "title": "Reel URL", "description": "Examples: https://www.facebook.com/reel/{id}/, https://www.facebook.com/watch/?v={id}, https://fb.watch/{short}, https://www.facebook.com/share/v/{token}/", "type": "string", "pattern": "^https://(((www|web|m)\\.)?facebook\\.com/|fb\\.watch/).+" } }, "required": [ "url" ] } }, "post_urls": { "title": "Facebook Video Post URLs", "type": "array", "description": "List of public Facebook video post URLs.", "items": { "type": "object", "properties": { "url": { "title": "Post URL", "description": "Public Facebook video post URL (supports facebook.com, web.facebook.com, www.facebook.com and fb.watch short links; share/v viewer links are not supported).", "type": "string", "pattern": "^https://((((www|web)\\.)?facebook\\.com/)|fb\\.watch/)" } }, "required": [ "url" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```