# Facebook Thumbnail Downloader (`scrapeflux/facebook-thumbnail-downloader`) Actor Facebook Thumbnail Downloader extracts and downloads thumbnail images from publicly available Facebook videos, posts, and pages. Quickly access preview images for content research, marketing analysis, media monitoring, archiving, and social media management workflows. - **URL**: https://apify.com/scrapeflux/facebook-thumbnail-downloader.md - **Developed by:** [ScrapeFlux](https://apify.com/scrapeflux) (community) - **Categories:** Social media, Developer tools, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 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 🚀 If you need the thumbnail image from Facebook Reels but don’t want to open each post manually, **Facebook Thumbnail Downloader** extracts the metadata for you from a list of Reel URLs. It’s ideal when you’re trying to **download facebook thumbnail** assets fast for research, reporting, or content ops. Facebook post thumbnail downloader workflows and “how to download facebook thumbnail” tasks are exactly what this actor speeds up. Marketers, analysts, and researchers use it to turn Reel links into usable thumbnail URLs in bulk. In one run, you can process multiple Reel URLs end-to-end and get results immediately in your dataset. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "url": "https://www.facebook.com/reel/961695579768224", "description": "A short public description pulled from the Reel page.", "uploader": "Unknown", "thumbnail_url": "https://example.com/thumbs/reel-961695579768224.jpg", "thumbnails": [ { "url": "https://example.com/thumbs/reel-961695579768224.jpg" }, { "url": "https://example.com/thumbs/reel-961695579768224.jpg" } ], "status": "success" } ```` | Field | Type | What It Tells You | |---|---|---| | `url` | string | The Reel URL associated with the scraped result, normalized for use in your pipeline. | | `description` | string | The public description text found for the Reel, helpful for categorization or notes. | | `uploader` | string | The uploader name when available (falls back to `"Unknown"` if missing). | | `thumbnail_url` | string | A direct thumbnail image URL for quick preview and linking. | | `thumbnails` | array | A list of thumbnail entries `{ "url": ... }` you can store or transform further. | | `status` | string | Indicates whether the record was successfully scraped (or not). | | `error` | string | If something fails, this communicates the problem in a compact form. | | `error_message` | string | Detailed error text when metadata extraction fails for a given URL. | | `webpage_url` | string | Included conceptually in the input→output mapping when available, otherwise the original `url` is used. | | `downloaded` | boolean | Represents whether the actor downloaded the media (this actor is set to skip downloads). | | `skip_download` | boolean | Confirms thumbnails are extracted without downloading files locally. | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "startUrls": [ { "url": "https://www.facebook.com/reel/961695579768224" }, { "url": "https://www.facebook.com/reel/123456789012345" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` | Parameter | Required | What It Does | |---|---|---| | `startUrls` | ✅ | A list of Facebook Reel URLs the actor will scrape to extract thumbnail metadata. | | `proxyConfiguration` | ⬜ | Proxy settings to use during scraping for better reliability on different networks. | | ↳ `proxy support` | ⬜ | When set to `true`, the actor uses Apify Proxy for the run. | | ↳ `proxy support` | ⬜ | Selects which proxy group(s) to use (for example, `"RESIDENTIAL"`). | *** ### What It Does Facebook Thumbnail Downloader pulls public thumbnail metadata from the Facebook Reel URLs you provide and writes each result straight into your Apify dataset. #### Extracts thumbnail metadata from your Reel list For each Reel URL in `startUrls`, the actor extracts key metadata fields, including a thumbnail image link. This makes it easy to build datasets for thumbnail reviews, thumbnails for ads, or cataloging. #### Built for “download facebook thumbnail” workflows If your workflow is “download facebook thumbnail” or “save facebook video thumbnail,” this actor turns links into direct thumbnail URLs you can reuse. It’s also useful for “facebook post thumbnail downloader” tasks where you need thumbnail assets at scale. #### Clean output structure for easy downstream use Each output record includes `url`, `description`, `uploader`, `thumbnail_url`, and a `thumbnails` array of `{ "url": ... }`. That means you can plug results directly into spreadsheets, databases, or media-management tools without extra mapping. #### Includes thumbnails even when only one is found When the actor finds a single thumbnail URL, it duplicates the single entry inside `thumbnails` so the list is consistent for downstream tooling. This is handy when your consumer expects more than one item. #### Error handling per URL If metadata extraction fails for a particular Reel, the actor still pushes a result containing the failing `url` along with an error field (`error` / `error_message` depending on what’s available). You keep partial progress even if one URL is problematic. #### Works with proxy support for more reliable runs The actor supports proxy configuration via `proxyConfiguration`, including `proxy support`. That helps keep thumbnail extraction stable when you’re processing larger batches of Facebook media. Overall, Facebook Thumbnail Downloader helps you quickly convert Reel URLs into usable thumbnail URLs—fast enough for bulk research and content operations. *** ### Why Facebook Thumbnail Downloader? There are plenty of ways to pull data from Facebook links—here’s why Facebook Thumbnail Downloader stands out. #### Consistent thumbnail-focused output You get direct thumbnail URLs (`thumbnail_url`) and a `thumbnails` list, which makes it straightforward to “extract facebook video thumbnail” style workflows. That structure is built for practical downstream use. #### Batch-friendly from the first run You provide multiple Reel URLs via `startUrls`, and the actor pushes results immediately as each URL is processed. This makes it easier to iterate quickly on a larger list of targets. #### Proxy-configurable reliability Built-in proxy support helps keep bulk processing running smoothly across different environments. This is especially useful when you’re running a “facebook thumbnail downloader” job repeatedly. *** ### Real-World Use Cases Here's how different teams put Facebook Thumbnail Downloader to work: **Marketing Teams**\ A performance marketer tests creative variants and needs thumbnails for ad libraries. They paste a set of Reel URLs into the actor, then export the dataset to quickly map thumbnail assets to campaigns. **Content Operations & Creators**\ A content manager organizes media from public Facebook posts and Reels into a centralized gallery. They use Facebook Thumbnail Downloader to collect thumbnails and descriptions in bulk, so building a thumbnail library is no longer manual. **Freelance Researchers**\ A researcher is compiling visual context for a media study and must reference each post by thumbnail and short description. They run the actor on a curated list, then export results to keep evidence organized. **Data Analysts**\ An analyst needs thumbnail URLs to join against other datasets (performance metrics, categorization tags, or content metadata). They scrape thumbnails from a list of Reels, then feed `thumbnail_url` and `thumbnails` into their ETL pipeline. **Developers & Automation Specialists**\ A developer automates enrichment for media-monitoring workflows. They trigger Facebook Thumbnail Downloader via the Apify API and store the `thumbnail_url` outputs for later rendering in dashboards—ideal for a “facebook thumbnail url extractor” use case. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Open the actor on Apify** — go to [console.apify.com](https://console.apify.com) and find Facebook Thumbnail Downloader. 2. **Enter your inputs** — paste your Reel URLs into `startUrls`. 3. **Configure proxy settings (optional)** — if you need extra reliability, set `proxyConfiguration` and enable `proxy support`. 4. **Start the run and watch the live log** — confirm each URL is processed. 5. **Open the Dataset tab to see live results** — thumbnails and metadata appear as the actor pushes records. 6. **Export in your preferred format** — download your results as JSON, CSV, or Excel. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Facebook Thumbnail Downloader fits directly into your existing workflow. Export formats include **JSON, CSV, and Excel** from the Apify dataset tab. For spreadsheet-first teams, this is an easy path to “facebook thumbnail saver” outputs you can share internally. For automation, you can pull results via the **Apify API**, connect with **Zapier / Make**, and trigger downstream steps using **webhooks** after the run completes. For deeper details (including scheduled runs and API usage), refer to Apify’s official documentation. *** ### Pricing Facebook Thumbnail Downloader runs on Apify, which includes a **free tier** — no credit card needed to start. Free tier coverage provides enough platform credits for a few real test runs, so you can validate thumbnail extraction before scaling up. For larger batches, runs are billed per Actor compute unit (CU) with no monthly fee lock-in. Start free at [apify.com](https://apify.com) — scale up when you need. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Per-URL failures | If a specific Reel fails, the actor still pushes a result with error details for that URL. | | Proxy configuration | You can use `proxyConfiguration` (including `proxy support`) to improve reliability. | | Batched inputs | Multiple URLs in `startUrls` are processed in a single run. | | Resilience in execution | The actor continues processing other URLs even if one URL encounters issues. | Limitations: This actor works with public Reel URLs you provide in `startUrls`. If a Reel’s metadata is unavailable or not retrievable, that particular URL may return an error record instead of a thumbnail. For enterprise-scale needs or custom configurations, reach out and we'll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes, Apify offers a free tier with monthly usage credits. This is typically enough to validate outcomes with a small set of Facebook Reel URLs before you scale. #### Do I need to log in or create an account on Facebook? No. You only need to provide public Reel URLs in `startUrls`. The actor extracts publicly available thumbnail metadata and does not require you to log in for the run. #### How accurate is the extracted data? Accuracy depends on what is publicly available for each Reel URL. The actor outputs fields like `thumbnail_url`, `description`, and `uploader` based on what it can retrieve for the provided links. #### How many results can I get per run? You can include multiple items in `startUrls` and the actor will process them in one run. The practical limit depends on your Apify run settings and throughput. #### How fresh is the data? The results reflect the metadata available at the time the actor runs. If a Reel’s thumbnail or description changes later, you’ll need to run again to refresh the dataset. #### Is this legal? Does it comply with GDPR / CCPA? This actor works with **publicly available data** from Reel URLs you provide. It’s your responsibility to ensure your use complies with GDPR, CCPA, and applicable platform terms, including how you store and process the resulting data. #### Can I export to Google Sheets or Excel? Yes. You can export from the Apify dataset tab as JSON, CSV, or Excel, then import into Google Sheets or other tools. If you prefer automation, you can also integrate via API, Zapier, or Make. #### Can I schedule this to run automatically? Yes. You can use Apify scheduling options to run the actor automatically on a schedule (for exact setup steps, check Apify’s scheduler documentation). #### Can I access results via the API? Yes. Apify supports programmatic access to run results via the Apify API. This is useful for keeping thumbnail datasets continuously updated. #### What happens when the actor encounters an error? If metadata extraction fails for a specific URL, the actor still pushes a record for that `url` including error information (for example `error` and/or `error_message`). Your dataset will include both successes and failures for full visibility. *** ### Get Help & Use Responsibly Got a question about Facebook Thumbnail Downloader or a feature you'd like added? Reach out at — we actively maintain this actor based on user feedback and can help troubleshoot run-time issues. This actor collects **publicly available data** from Reel pages. It does not access private accounts, login-gated pages, or password-protected content. It’s your responsibility to comply with GDPR, CCPA, and platform Terms of Service when using and storing the 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("scrapeflux/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("scrapeflux/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 scrapeflux/facebook-thumbnail-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeflux/facebook-thumbnail-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Thumbnail Downloader", "description": "Facebook Thumbnail Downloader extracts and downloads thumbnail images from publicly available Facebook videos, posts, and pages. Quickly access preview images for content research, marketing analysis, media monitoring, archiving, and social media management workflows.", "version": "1.0", "x-build-id": "ZzSKlNKYYfkAcgoh0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeflux~facebook-thumbnail-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeflux-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/scrapeflux~facebook-thumbnail-downloader/runs": { "post": { "operationId": "runs-sync-scrapeflux-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/scrapeflux~facebook-thumbnail-downloader/run-sync": { "post": { "operationId": "run-sync-scrapeflux-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 } } } } } } } } } } ```