# Facebook Thumbnail Downloader (`scraperoka/facebook-thumbnail-downloader`) Actor 📥 Download Facebook thumbnails fast with Facebook Thumbnail Downloader! ✨ Save previews in seconds for sharing, archiving, or content research. 🔍 Simple, reliable, and SEO-friendly—get the image you need anytime. 🚀 Try it now! - **URL**: https://apify.com/scraperoka/facebook-thumbnail-downloader.md - **Developed by:** [Scraperoka](https://apify.com/scraperoka) (community) - **Categories:** Social media, SEO tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 🚀 Manually visiting Facebook Reels to grab thumbnails is slow and inconsistent. **Facebook Thumbnail Downloader** automatically extracts Reel metadata and thumbnail image URLs from your list of links—ideal for marketers, researchers, and growth teams. This Facebook Thumbnail Downloader scraper makes it easy to download thumbnails from Facebook posts and Reels at scale, producing thousands of usable records in minutes. --- ### What You Get: Sample Output Here's a sample record from a single run: ```json { "url": "https://www.facebook.com/reel/961695579768224", "description": "A short description pulled from the Reel page.", "uploader": "Unknown", "thumbnail_url": "https://example.com/thumbnails/961695579768224.jpg", "thumbnails": [ { "url": "https://example.com/thumbnails/961695579768224.jpg" }, { "url": "https://example.com/thumbnails/961695579768224.jpg" } ] } ```` | Field | Type | What It Tells You | |---|---|---| | `url` | string | The Reel URL associated with this record (normalized to the page URL when available) | | `description` | string | Reel description text to help you quickly understand the content context | | `uploader` | string | The account/channel name used for quick sorting and filtering | | `thumbnail_url` | string | null | A direct thumbnail image URL for quick use in dashboards, mockups, or pipelines | | `thumbnails` | array | A list of thumbnail entries the actor found for the Reel (useful when multiple thumbnail candidates exist) | | `thumbnails[].url` | string | The thumbnail image URL inside the thumbnails array | | `error` | string | When something fails, you’ll still get a record with `url` plus an error message | | `status` | string | null | (Not provided by the actor output) — failure handling is returned via `error` fields instead | | `charged_event_name` | string | null | (Not part of dataset schema; internal billing event name) | | `resolution_note` | string | null | (Not provided by the actor output) — no resolution details are stored in the dataset | Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard. *** ### Why Facebook Thumbnail Downloader? There are a lot of ways to pull data from Facebook Reels — here’s what sets Facebook Thumbnail Downloader apart. #### Thumbnail-ready output (not just links) Facebook Thumbnail Downloader delivers `thumbnail_url` plus a `thumbnails` list, so you can directly feed “facebook thumbnail saver” workflows like UI previews, content inventories, and thumbnail libraries. #### Output is built for bulk runs Give it a list of Reel URLs via `startUrls`, and the actor processes them and writes results to your dataset as it goes—perfect for “download thumbnails from Facebook post” style projects and batch thumbnail extraction tasks. #### Resilient handling with clear error records If metadata extraction fails for a specific URL, the actor still pushes a dataset record with `url` and an `error`, so you can audit failures without losing the rest of your run. #### Uses your proxy configuration for reliability Facebook Thumbnail Downloader supports proxy settings via `proxyConfiguration`, helping improve reliability for larger batches where consistent access matters. *** ### Configuring Your Run Drop this into your `input.json` to get started: ```json { "startUrls": [ { "url": "https://www.facebook.com/reel/961695579768224" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` | Parameter | Required | What It Does | |---|---|---| | `startUrls` | ✅ | List of Facebook Reel URLs to scrape metadata from (each item should include a `url`). | | `proxyConfiguration` | ⬜ | Proxy settings for your run. Helps improve reliability for bulk scraping. | | ↳ `proxy support` | ⬜ | When `true`, the actor routes requests through Apify Proxy. | | ↳ `proxy support` | ⬜ | Proxy group selection used by the actor when creating proxy configuration (for example, `RESIDENTIAL`). | *** ### Core Capabilities #### Bulk Reel thumbnail extraction Facebook Thumbnail Downloader takes your `startUrls` list and extracts metadata for each Reel, including description, uploader/channel name, and thumbnail URLs—ideal for “facebook reel thumbnail downloader” and “grab thumbnail from facebook video” style use cases. #### Complete, structured thumbnail outputs You get both `thumbnail_url` and a `thumbnails` array containing objects with `url`. That means you can power “facebook thumbnail extractor” workflows without extra parsing steps. #### Resilience and per-URL error handling The actor pushes a result for each input URL. When it can’t extract metadata, it records `{ "url": ..., "error": ... }`, so your dataset stays complete and audit-friendly. #### Proxy support for smoother large-batch runs With `proxyConfiguration`, Facebook Thumbnail Downloader lets you select proxy behavior to improve reliability when processing many URLs. #### Real-time dataset writing Results are written to the dataset as each URL is processed, so you don’t have to wait until the end to start reviewing “download facebook thumbnails” outputs. *** ### Who Gets the Most Out of This **Content marketers** use Facebook Thumbnail Downloader to quickly build thumbnail libraries for campaigns, making it easy to compare creative variations and refresh assets without manually saving “facebook post thumbnail downloader” images one by one. **Social media strategists and analysts** put the actor to work for bulk audits of Reel creatives—using `description` and `uploader` to segment content, while using `thumbnail_url` and `thumbnails` to create visual inventories. **Growth teams** rely on Facebook Thumbnail Downloader to automate creative research: feed in candidate Reel links, then use the thumbnail outputs to speed up ideation and production briefs (a practical “facebook image thumbnail downloader” workflow). **Automation specialists (technical)** integrate the dataset into their pipelines, exporting the thumbnail URLs and descriptions to downstream tools via the Apify API and automations—so “how to download facebook thumbnail” becomes a one-click workflow. *** ### Step-by-Step: How to Use It No coding needed. Here's how to run Facebook Thumbnail Downloader from start to finish: 1. **Open** the actor on Apify — visit [console.apify.com](https://console.apify.com) and open the Facebook Thumbnail Downloader actor page. 2. **Enter** your inputs — add your Reel links in `startUrls`. 3. **Configure** proxy settings — optionally set `proxyConfiguration` (recommended for more reliable bulk runs). 4. **Hit Run** and watch the live log for progress while each URL is processed. 5. **View** results in the dataset tab — each Reel will appear with its thumbnail fields (or an `error` if extraction fails). 6. **Export** as JSON, CSV, or Excel — download directly from the Apify dashboard. The whole process takes under 5 minutes to set up. *** ### Integrations & Export Options Once your data is collected, Facebook Thumbnail Downloader plugs directly into your existing workflow. Export formats are available directly from the Apify dataset tab, including JSON and spreadsheet-friendly formats like CSV/Excel—great for teams building “facebook thumbnail saver” libraries or research trackers. For automation and scaling, you can use the Apify API to pull results programmatically, and you can connect runs to downstream actions using webhooks, Zapier, or Make (refer to [Apify docs](https://apify.com/docs/api) for full details). *** ### Pricing & Free Trial Facebook Thumbnail Downloader runs on the Apify platform, which offers a **free tier** — no credit card required to get started. The exact usage and credit details depend on your plan and the platform’s current pricing model. You can typically run several test jobs on the free credits, then scale when you’re ready for larger batches. Start for free at [apify.com](https://apify.com) and scale when you're ready. *** ### Reliability & Performance | What We Handle | How | |---|---| | Bulk processing | Processes each URL from `startUrls` and writes results to your dataset | | Proxy usage | Supports `proxyConfiguration` for more reliable runs | | Failures per URL | If extraction fails, the actor still pushes a record with `url` and an `error` | | Output consistency | Returns a structured object with thumbnail fields when successful | **Limitations:** This actor works on publicly accessible Reel pages and focuses on thumbnail and metadata fields available through the extraction step. It can’t guarantee thumbnails for every Reel (some may lack thumbnail data), so failure-state records may appear in the dataset when metadata isn’t returned. For enterprise-scale runs, contact us to discuss custom configurations. *** ### Frequently Asked Questions #### Is there a free plan or trial? Yes. Apify offers a free tier with credits for running actors, so you can test Facebook Thumbnail Downloader before scaling up. #### Do I need to log in to Facebook to use this? No. The actor is designed to scrape metadata and thumbnails from publicly available Reel pages, without requiring you to log in. #### How accurate is the data? The actor extracts the `description`, `uploader`, and thumbnail URL fields that are available during extraction. If a Reel doesn’t provide thumbnail data, you may see empty or failure-state outputs for that URL. #### How many results can I get per run? You can submit as many Reel URLs as you need in `startUrls`. The practical limits depend on your Apify run environment and the current platform constraints. #### How often is the data updated / how fresh is it? Results are captured when you run the actor. If a Reel’s description or thumbnail changes later, you’ll need to rerun Facebook Thumbnail Downloader to capture the updated fields. #### Is this legal? Does it comply with GDPR / CCPA? Use responsibly. Facebook Thumbnail Downloader only processes publicly available data, but you’re responsible for ensuring your usage complies with GDPR, CCPA, and applicable platform rules. #### Can I export results to Google Sheets or Excel? Yes. You can export your Apify dataset from the dashboard in formats like JSON and spreadsheet-friendly files such as CSV/Excel. You can then import it into tools like Google Sheets or use automations. #### Can I run this on a schedule automatically? Yes. You can set up scheduled runs through Apify so Facebook Thumbnail Downloader runs automatically on a recurring schedule. #### Can I access this via API? Yes. You can trigger runs and retrieve dataset results via the Apify API. See [Apify API documentation](https://apify.com/docs/api) for details. #### What happens if the actor hits an error? If metadata extraction fails for a specific URL, the actor pushes a dataset record containing the `url` and an `error` message, so the rest of your `startUrls` inputs can still complete. *** ### Need Help or Have a Request? Got a question about Facebook Thumbnail Downloader or want a new feature added? Reach out at . We respond quickly and actively maintain this actor based on user feedback—ideas like “batch CSV upload” and “webhook on completion” are especially welcome. *** ### Disclaimer & Responsible Use *Facebook Thumbnail Downloader is the fastest, most reliable way to download Facebook thumbnails at scale — start your free run today.*\ This actor processes **publicly available data** from Facebook Reel pages. It does not access private accounts, login-gated content, or password-protected pages. You’re responsible for complying with GDPR, CCPA, and applicable platform ToS when storing and using the extracted results. For data-removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # Actor input Schema ## `startUrls` (type: `array`): List of Facebook Reel URLs (e.g., https://www.facebook.com/reel/961695579768224). ## `proxyConfiguration` (type: `object`): Select proxies to be used by your crawler. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.facebook.com/reel/961695579768224" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "startUrls": [ { "url": "https://www.facebook.com/reel/961695579768224" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scraperoka/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 = { "startUrls": [{ "url": "https://www.facebook.com/reel/961695579768224" }], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("scraperoka/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 '{ "startUrls": [ { "url": "https://www.facebook.com/reel/961695579768224" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scraperoka/facebook-thumbnail-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperoka/facebook-thumbnail-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Thumbnail Downloader", "description": "📥 Download Facebook thumbnails fast with Facebook Thumbnail Downloader! ✨ Save previews in seconds for sharing, archiving, or content research. 🔍 Simple, reliable, and SEO-friendly—get the image you need anytime. 🚀 Try it now!", "version": "1.0", "x-build-id": "fho7Xc03gwegyRTq7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperoka~facebook-thumbnail-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperoka-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/scraperoka~facebook-thumbnail-downloader/runs": { "post": { "operationId": "runs-sync-scraperoka-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/scraperoka~facebook-thumbnail-downloader/run-sync": { "post": { "operationId": "run-sync-scraperoka-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Facebook Thumbnail Downloader URLs", "type": "array", "description": "List of Facebook Reel URLs (e.g., https://www.facebook.com/reel/961695579768224).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } } } } } } } } } ```