# Facebook Reels Thumbnail Downloader (`codenest/facebook-reels-thumbnail-downloader`) Actor

Effortlessly extract high-quality Facebook Reels thumbnails with complete metadata including uploader details, content descriptions, and multiple CDN-hosted image variants for professional media analysis and content archiving workflows. ✨Facebook Reels Thumbnail Downloader.

- **URL**: https://apify.com/codenest/facebook-reels-thumbnail-downloader.md
- **Developed by:** [CodeNest](https://apify.com/codenest) (community)
- **Categories:** Social media, Developer tools, Automation
- **Stats:** 16 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Facebook Reels Thumbnail Downloader - Professional Media Preview Extraction Tool

**Enterprise-grade solution for downloading Facebook Reels thumbnails with comprehensive metadata, multiple image variants, and direct CDN access.**

***

### Overview

The Facebook Reels Thumbnail Downloader is a sophisticated automation tool designed for professionals who require high-quality Facebook Reels preview images with complete contextual metadata. This actor extracts thumbnail assets from provided Facebook Reel URLs while delivering multiple image variants, detailed content information, and direct access to visual media assets.

#### Core Capabilities

- **Multi-variant thumbnail extraction** with direct CDN access
- **Complete metadata preservation** including creator information and content description
- **High-resolution image URLs** for professional use cases
- **Comprehensive content context** with uploader details and descriptive text
- **Batch processing support** for multiple Reels in single operation

***

### Input Configuration

```json
{
  "reel_urls": [
    {
      "url": "https://web.facebook.com/reel/1831270064408357",
      "method": "GET"
    }
  ]
}
```

#### Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reel_urls` | Array | Yes | Facebook Reel URLs to process |
| `url` | String | Yes | Valid Facebook Reel URL (web.facebook.com/reel/ format) |
| `method` | String | Yes | HTTP method (GET recommended) |

***

### Output Structure

```json
[
  {
    "url": "https://www.facebook.com/reel/1831270064408357/",
    "description": "Atlantic Ocean   #ship #insta #sea #sealife #instagram #instamood #shipping #explore #trendingreelsvideo",
    "uploader": "Mariner Vicky",
    "thumbnail_url": "https://scontent-atl3-3.xx.fbcdn.net/v/t15.5256-10/529773654_1307743380784400_2091905933132907197_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=1&ccb=1-7&_nc_sid=50ce42&_nc_ohc=9vj0Zw4FXFoQ7kNvwEmh4Nc&_nc_oc=Adk2_gBXjr0l4m-zvBihMFjLS05z-XFdmeIhLyjXBm8MfVih8ZerciJmgtN3k0HVY4mbs0FXG_Y8SrWcTENNp8lA&_nc_zt=23&_nc_ht=scontent-atl3-3.xx&_nc_gid=WpgfX5Xtxwgoe9mNR2_Iqw&oh=00_Afcsat34ZScmN-5kWe3U9NBXvm4h8mQaWBGzN_nQyHJrWg&oe=68EB1A9C",
    "thumbnails": [
      {
        "url": "https://scontent-atl3-3.xx.fbcdn.net/v/t15.5256-10/529773654_1307743380784400_2091905933132907197_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=1&ccb=1-7&_nc_sid=50ce42&_nc_ohc=9vj0Zw4FXFoQ7kNvwEmh4Nc&_nc_oc=Adk2_gBXjr0l4m-zvBihMFjLS05z-XFdmeIhLyjXBm8MfVih8ZerciJmgtN3k0HVY4mbs0FXG_Y8SrWcTENNp8lA&_nc_zt=23&_nc_ht=scontent-atl3-3.xx&_nc_gid=WpgfX5Xtxwgoe9mNR2_Iqw&oh=00_Afcsat34ZScmN-5kWe3U9NBXvm4h8mQaWBGzN_nQyHJrWg&oe=68EB1A9C"
      }
    ]
  }
]
```

#### Output Field Documentation

**Content Metadata Section**
| Field | Description |
|-------|-------------|
| `url` | Normalized Facebook Reel URL (canonical format) |
| `description` | Complete reel description text with hashtags and captions |
| `uploader` | Content creator's display name or page name |

**Thumbnail Assets**
| Field | Description |
|-------|-------------|
| `thumbnail_url` | Primary high-quality thumbnail image URL |
| `thumbnails` | Array containing all available thumbnail variants |

**Thumbnail Object Specification**
| Field | Description |
|-------|-------------|
| `url` | Direct CDN URL to thumbnail image resource |
| `resolution` | Image dimensions in pixels (when available) |
| `format` | Image format specification (jpg, webp, etc.) |

***

### Asset Quality & Specifications

The Facebook Reels Thumbnail Downloader provides direct access to Facebook's CDN-hosted thumbnail resources:

#### Image Characteristics

- **High Resolution**: Typically 960x960 pixels or higher
- **Format**: JPEG with optimized compression
- **CDN Delivery**: Global content delivery network for fast access
- **Direct Links**: Bypass intermediate processing layers

#### Thumbnail Variants

The actor extracts all available thumbnail versions, including:

1. **Primary Thumbnail** - Main preview image used by Facebook
2. **Alternative Variants** - Additional image versions when available
3. **Fallback Options** - Multiple access points for reliability

***

### Technical Features

#### Advanced Extraction Technology

- Direct Facebook CDN access for maximum image quality
- URL normalization and validation
- Comprehensive error handling and fallback mechanisms
- Batch processing capabilities for efficiency

#### Metadata Preservation

- Complete description text extraction with hashtags
- Uploader attribution preservation
- Content context maintenance
- Structured data organization

#### Reliability Engineering

- Multiple CDN endpoint access
- Redundant thumbnail URL provision
- Comprehensive error handling
- URL validation and normalization

***

### Enterprise Applications

#### Social Media Monitoring

- Track brand mentions and visual content
- Monitor competitor thumbnail strategies
- Analyze visual content trends across industries

#### Content Analysis Platforms

- Extract thumbnails for content categorization
- Analyze visual trends in social media
- Build image databases for machine learning

#### Marketing Intelligence

- Study thumbnail effectiveness for engagement
- Analyze visual content strategies
- Archive campaign visual assets for compliance

#### Media Research

- Academic research on social media visuals
- Trend analysis in visual content creation
- Cross-platform content comparison studies

#### Development Teams

- Integrate Facebook content previews into applications
- Build social media aggregation tools
- Develop content monitoring dashboards
- Create automated thumbnail processing pipelines

***

### Quality Assurance

The Facebook Reels Thumbnail Downloader ensures:

- **Maximum Resolution Access**: Direct CDN links for highest quality images
- **Metadata Accuracy**: Precise extraction of descriptions and uploader information
- **Reliability**: Multiple fallback options and robust error handling
- **Performance**: Optimized for batch processing and high-volume operations

***

**Professional-Grade Facebook Reels Thumbnail Extraction for Enterprise Workflows**

# Actor input Schema

## `reel_urls` (type: `array`):

List of public Facebook Reels URLs. Also supports fb.watch and will resolve share/v links.

## Actor input object example

```json
{
  "reel_urls": [
    {
      "url": "https://web.facebook.com/reel/1831270064408357"
    }
  ]
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "reel_urls": [
        {
            "url": "https://web.facebook.com/reel/1831270064408357"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("codenest/facebook-reels-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "reel_urls": [{ "url": "https://web.facebook.com/reel/1831270064408357" }] }

# Run the Actor and wait for it to finish
run = client.actor("codenest/facebook-reels-thumbnail-downloader").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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"
    }
  ]
}' |
apify call codenest/facebook-reels-thumbnail-downloader --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,codenest/facebook-reels-thumbnail-downloader"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/PxRSSfg6m5CiWMoIf/builds/TxmAbjInUnN1atfp4/openapi.json