# Instagram Reels Thumbnail Scraper (`codenest/instagram-reels-thumbnail-scraper`) Actor

Extract high-quality thumbnails from Instagram Reels! This scraper delivers multiple preview images with full metadata, engagement stats, and secure Apify KV storage URLs. Perfect for marketers 📈, researchers 🔍, and developers 📱 analysing visual content trends. Instagram Reels Thumbnail Scraper.

- **URL**: https://apify.com/codenest/instagram-reels-thumbnail-scraper.md
- **Developed by:** [CodeNest](https://apify.com/codenest) (community)
- **Categories:** Social media, Developer tools, Other
- **Features:** Limited permissions
- **Stats:** 22 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.00 / 1,000 instagram reel scrapeds

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/actors/running/actors-in-store.md#pay-per-event

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

## Instagram Reels Thumbnail Scraper - Professional Thumbnail Extraction Tool

**🚀 Effortlessly extract high-quality thumbnails from Instagram Reels with our enterprise-grade Instagram Reels Thumbnail Scraper! This powerful Apify actor enables you to batch download multiple thumbnails while preserving comprehensive metadata and direct CDN access.**

***

### 📖 Overview

Need to analyze Instagram content or gather thumbnails for research? This **Instagram Reels Thumbnail Scraper** delivers:

- Multiple thumbnail extraction: Get all available preview images
- Apify Storage: Secure download URLs with encryption
- Full engagement metrics: Likes, comments, and creator data
- Technical metadata: Complete image specifications and codec details

Perfect for social media analysts 📊, content researchers 🔍, and app developers 📱!

### ⚡ Core Capabilities/Key Features

#### 🖼️ Thumbnail Options

- Multiple Thumbnails: Extract all available preview images
- High-Quality Images: 640x1136 resolution thumbnails
- Bulk Processing: Handle multiple Instagram Reels URLs per run
- Direct URLs: Apify storage links for easy access

#### 📊 Metadata Mastery

- Engagement Analytics: Likes and comments count
- Creator Information: Author usernames and profiles
- Content Details: Descriptions and upload dates
- Technical Specs: Complete image metadata and codec information

#### 🔧 Advanced Tech

- Proxy Support: Residential IP rotation capabilities
- Secure Storage: Encrypted thumbnail URLs
- Quality Preservation: Original image quality maintenance

***

### 🎯 Input Configuration

Just enter the Instagram Reels URLs in the Input Section then click the "start" button and wait for the results. This **Instagram Reels Thumbnail Scraper** accepts URLs like this:

```json
{
  "reel_urls": [
    {
      "url": "https://www.instagram.com/reel/DKiypWLMTX-/?utm_source=ig_web_copy_link&igsh=MzRlODBiNWFlZA==",
      "method": "GET"
    }
  ]
}
```

#### 📋 Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reel_urls` | Array | Yes | Instagram Reel URLs to process |
| `url` | String | Yes | Valid Instagram Reel URL |
| `saveThumbnailsToKVS` | Boolean | No | Download thumbnails directly into Apify Key-Value Store (Default: true) |
| `proxy` | Object | No | Proxy settings (Residential proxy recommended) |

***

### 💰 Pay-Per-Event Pricing Model

This Actor operates under Apify's **Pay-Per-Event (PPE)** pricing model. You only pay for what you scrape:

| Event Name | Pricing Type | Description |
|------------|--------------|-------------|
| `apify-actor-start` | Synthetic (Startup) | Covers Actor initialization and compute resources. |
| `instagram-reel-thumbnail` | Custom (Per Reel) | Charged per Instagram Reel successfully processed with full thumbnail extraction, Key-Value Store hosting, and metadata. |

- **🆓 Free Plan:** Free tier users can test and scrape up to **3 Reels per run**.
- **💎 Paid Plan:** Paying Apify users enjoy **unlimited Reel scraping** with automatic spending limit protection.

***

### 📄 Output Structure

This **Instagram Reels Thumbnail Scraper** provides comprehensive output like this:

```json
[
  {
    "shortcode": "Dex0oMRRhQV",
    "thumbnail_url": "https://api.apify.com/v2/key-value-stores/default/records/thumb_10_b3615d1f-ef55-4d50-a6a9-fc149ba3fd3d.jpg",
    "author_username": "WNBA",
    "author_name": "wnba",
    "description": "Video by wnba",
    "likes": "8.1K",
    "comments": "210",
    "views": "2.4M",
    "upload_date": "2026-10-22",
    "duration": 12.133,
    "video_url": "https://instagram.fdac134-1.fna.fbcdn.net/...",
    "original_url": "https://www.instagram.com/reels/Dex0oMRRhQV/?hl=en",
    "thumbnail_items_metadata": [
      {
        "url": "https://api.apify.com/v2/key-value-stores/default/records/thumb_10_b3615d1f-ef55-4d50-a6a9-fc149ba3fd3d.jpg",
        "index": 10,
        "width": 720,
        "height": 1280,
        "resolution": "720x1280",
        "metadata": {
          "streams": [
            {
              "index": 0,
              "codec_name": "mjpeg",
              "codec_long_name": "Motion JPEG",
              "profile": "Progressive",
              "codec_type": "video",
              "width": 720,
              "height": 1280,
              "pix_fmt": "yuvj420p",
              "color_space": "bt470bg"
            }
          ],
          "format": {
            "format_name": "image2",
            "format_long_name": "image2 sequence",
            "duration": "0.040000",
            "size": "88575",
            "bit_rate": "17715000"
          }
        }
      }
    ]
  }
]
```

#### 📊 Output Field Documentation

**Content Metadata Section**
| Field | Description |
|-------|-------------|
| `shortcode` | Unique Instagram Reel ID (e.g. `Dex0oMRRhQV`) |
| `thumbnail_url` | Primary highest-resolution thumbnail preview image |
| `author_username` | Content creator's Instagram handle |
| `author_name` | Creator's channel or display name |
| `description` | Reel caption / description text |
| `likes` | Formatted likes count (e.g. `8.1K`, `1.2M`) |
| `comments` | Formatted comments count |
| `views` | Total video views / play count |
| `upload_date` | Human-readable publication date (ISO `YYYY-MM-DD`) |
| `duration` | Video length in seconds |
| `video_url` | Direct downloadable MP4 video stream link |
| `original_url` | Original input Instagram Reel URL |

**Thumbnail Assets**
| Field | Description |
|-------|-------------|
| `thumbnail_items_metadata` | Array of all available thumbnails |
| `url` | Direct thumbnail download URL |
| `index` | Thumbnail sequence number |

**Technical Image Metadata**
| Field | Description |
|-------|-------------|
| `codec_name` | Image codec (mjpeg, etc.) |
| `width` | Image width in pixels |
| `height` | Image height in pixels |
| `pix_fmt` | Pixel format specification |
| `color_space` | Color space information |
| `size` | File size in bytes |
| `bit_rate` | Bit rate information |

***

### 🎨 Thumbnail Quality & Specifications

The **Instagram Reels Thumbnail Scraper** automatically extracts high-quality thumbnails with the following specifications:

#### 🖼️ Image Quality

- **Resolution**: 640x1136 pixels
- **Format**: JPEG with Motion JPEG codec
- **Color Space**: BT.470 BG
- **Pixel Format**: YUVJ420P progressive

#### 🔍 Technical Details

- Multiple thumbnail variants per Reel
- Complete codec specifications
- File size and bit rate metadata
- Duration and timing information

***

### 🛠️ Technical Features

#### 🖼️ Advanced Image Extraction

- Multiple thumbnail capture per Reel
- High-resolution image preservation
- Motion JPEG codec support
- Progressive image formatting

#### 📈 Comprehensive Analytics

- Engagement metrics extraction
- Creator attribution data
- Content description capture
- Upload timestamp preservation

#### 🛡️ Reliability Features

- Secure Apify storage integration
- Comprehensive error handling
- URL validation and normalization
- Proxy support for reliable access

***

### 💼 Use Cases

- **Social Media Managers** – Analyze competitor thumbnail strategies
- **Content Researchers** – Study visual content patterns
- **App Developers** – Build thumbnail-powered applications
- **Marketing Agencies** – Gather visual intelligence data
- **Data Analysts** – Track engagement correlation with thumbnails

This **Instagram Reels Thumbnail Scraper** is perfect for anyone needing comprehensive thumbnail data from Instagram Reels content.

***

#### 🌟 Why Choose Our Instagram Reels Thumbnail Scraper?

- **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 Instagram changes
- **Comprehensive Data**: Get all thumbnails and metadata in one place
- **Secure Access**: Encrypted storage URLs for protected downloads

***

#### ⚠️ Limitations

- Only works with public Instagram Reels
- The **Instagram Reels Thumbnail Scraper** may hit rate limits depending on Instagram's restrictions
- Thumbnail availability depends on Instagram's CDN

### 🔗🛠 Related Actors (Full Content Scraping Suite)

Explore our full scraping suite for enhanced social media scraping:

#### 📸 Instagram Scrapers:

- [Instagram Reels Downloader](https://apify.com/codenest/instagram-reels-downloader)
- [Instagram Reels Thumbnail Downloader](https://apify.com/codenest/instagram-reels-thumbnail-downloader)
- [Instagram Video Downloader](https://apify.com/codenest/instagram-video-downloader)
- [Instagram Reels Scraper & Downloader](https://apify.com/codenest/instagram-reels-downloader-scraper)
- [Instagram Reels Audio Downloader](https://apify.com/codenest/instagram-reels-audio-downloader)
- [Instagram Post Downloader (Image & Video)](https://apify.com/codenest/instagram-post-downloader-image-video)
- [Instagram Reels Audio Scraper & Downloader](https://apify.com/codenest/instagram-reels-audio-scraper-downloader)
- [Instagram Story Downloader](https://apify.com/codenest/instagram-story-downloader)
- [Instagram Story Scraper](https://apify.com/codenest/instagram-story-scraper)

***

### 📧 Need Customization?

Want \*higher resolution thumbnails, \*\*batch processing enhancements, or \**additional metadata fields*?

✉ Email *<codenest2.0@gmail.com>* for tailored solutions with our **Instagram Reels Thumbnail Scraper**!

***

# Actor input Schema

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

A list of public Instagram Reels URLs. Each item can be a string URL or an object with {"url": "https://..."}.

## `saveThumbnailsToKVS` (type: `boolean`):

If enabled, downloads extracted thumbnails directly into the default Apify Key-Value Store for persistent hosting.

## `proxy` (type: `object`):

Proxy configuration for Instagram requests. Automatically falls back to standard proxy or direct access if residential proxies are unavailable.

## Actor input object example

```json
{
  "reel_urls": [
    {
      "url": "https://www.instagram.com/reel/DI4WihvBwKC/?utm_source=ig_web_copy_link"
    }
  ],
  "saveThumbnailsToKVS": true,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

Tabular overview of scraped Reels thumbnails, creators, and engagement metrics.

## `results` (type: `string`):

Dataset containing all scraped Instagram Reels metadata and thumbnail records.

## `outputRecord` (type: `string`):

Consolidated JSON array of all scraped Instagram Reels thumbnails stored in the default Key-Value Store.

# 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://www.instagram.com/reel/DI4WihvBwKC/?utm_source=ig_web_copy_link"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("codenest/instagram-reels-thumbnail-scraper").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://www.instagram.com/reel/DI4WihvBwKC/?utm_source=ig_web_copy_link" }] }

# Run the Actor and wait for it to finish
run = client.actor("codenest/instagram-reels-thumbnail-scraper").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://www.instagram.com/reel/DI4WihvBwKC/?utm_source=ig_web_copy_link"
    }
  ]
}' |
apify call codenest/instagram-reels-thumbnail-scraper --silent --output-dataset

```

## MCP server setup

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

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/iKPlNmZbGiREg5rs5/builds/uuwckcY6h4kN4burV/openapi.json