# YouTube Thumbnail Scraper & Downloader (`codenest/youtube-thumbnail-scraper-downloader`) Actor

Easily scrape and download YouTube thumbnails from videos, shorts and also from YouTube-kids videos in 8K to 360p resolutions with complete metadata including video titles, channel information, and direct CDN access etc. for professional media workflows.🎆YouTube Thumbnail Scraper & Downloader.

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

## Pricing

$5.00/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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## YouTube Thumbnail Scraper & Downloader - Professional Thumbnail Extraction Tool

**Efficiently scrape and download YouTube thumbnails with our powerful YouTube Thumbnail Scraper & Downloader actor! This Apify actor enables you to extract high-quality thumbnails in multiple resolutions with comprehensive metadata for any YouTube video.**

***

### 🎯 Overview

Need high-quality YouTube thumbnails for content analysis or marketing? This **YouTube Thumbnail Scraper & Downloader** delivers:

- **Multiple Resolutions**: Access thumbnails from 360p to 8K quality
- **Complete Metadata**: Titles, channels, upload dates, dimensions
- **Bulk Processing**: Handle multiple videos simultaneously
- **Direct CDN Links**: Get original YouTube image URLs

Perfect for marketers 📊, content creators 🎬, SEO specialists 🔍, and data analysts 📈!

### ⚡ Core Capabilities/Key Features

#### 🖼️ Thumbnail Options

- **Multiple Qualities**: 360p to 8K resolution thumbnails
- **Max Resolution**: Always get the highest available quality
- **Bulk Mode**: Process dozens of YouTube URLs per run
- **Direct URLs**: Original YouTube CDN thumbnail links

#### 📊 Metadata Mastery

- **Video Titles**: Complete title extraction
- **Channel Information**: Creator channel names
- **Upload Dates**: YYYY-MM-DD timestamp format
- **Dimension Data**: Exact width and height measurements

#### 🛠️ Advanced Tech

- **Proxy Support**: Residential IP rotation capability
- **URL Validation**: Automatic YouTube URL verification
- **Quality Fallback**: Smart resolution selection

***

### 📥 Input Configuration

Simply enter YouTube video URLs in the Input Section then click "start" to begin scraping with our **YouTube Thumbnail Scraper & Downloader**. The input format is:

```json
{
  "video_urls": [
    {
      "url": "https://www.youtube.com/watch?v=cmGo8hM_nhs",
      "method": "GET"
    }
  ]
}
```

#### 📋 Input Specifications

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_urls` | Array | Yes | YouTube video URLs to process |
| `url` | String | Yes | Valid YouTube video URL |
| `method` | String | Yes | HTTP method (GET recommended) |

***

### 📤 Output Structure

The **YouTube Thumbnail Scraper & Downloader** provides comprehensive output:

```json
[
  {
    "original_url": "https://www.youtube.com/watch?v=cmGo8hM_nhs",
    "title": "REAL 8K HDR - Best of 8K Video ULTRA HD - Dolby Vision",
    "channel": "4K Video ULTRA HD",
    "duration": "10m 17s",
    "thumbnail": "https://i.ytimg.com/vi/cmGo8hM_nhs/maxresdefault.jpg",
    "thumbnail_metadata": {
      "thumbnail_url": "https://i.ytimg.com/vi/cmGo8hM_nhs/maxresdefault.jpg",
      "thumbnail_id": "cmGo8hM_nhs",
      "thumbnail_ext": null,
      "thumbnail_width": 7680,
      "thumbnail_height": 4320,
      "thumbnail_resolution": "7680x4320",
      "thumbnail_channel": "4K Video ULTRA HD",
      "thumbnail_upload_date": "2025-04-09",
      "thumbnail_title": "REAL 8K HDR - Best of 8K Video ULTRA HD - Dolby Vision"
    },
    "qualities": [
      {
        "resolution": 4320,
        "thumbnail": "https://i.ytimg.com/vi/cmGo8hM_nhs/maxresdefault.jpg",
        "explanation": "Thumbnail for resolution 4320"
      }
    ]
  }
]
```

#### 📊 Output Field Documentation

**Video Metadata Section**
| Field | Description |
|-------|-------------|
| `original_url` | Original YouTube video URL |
| `title` | Complete video title |
| `channel` | Video creator's channel name |
| `duration` | Video length in minutes:seconds |

**Thumbnail Metadata**
| Field | Description |
|-------|-------------|
| `thumbnail_url` | Primary thumbnail download URL |
| `thumbnail_width` | Image width in pixels |
| `thumbnail_height` | Image height in pixels |
| `thumbnail_resolution` | Full resolution string |
| `thumbnail_channel` | Source channel name |
| `thumbnail_upload_date` | Video publication date |

**Quality Options**
| Field | Description |
|-------|-------------|
| `resolution` | Vertical resolution in pixels |
| `thumbnail` | Quality-specific thumbnail URL |
| `explanation` | Resolution description |

***

### 🎚️ Quality Tiers Available

The **YouTube Thumbnail Scraper & Downloader** automatically detects and provides multiple resolution options:

1. **Ultra HD 8K** - 7680x4320 (Maximum quality available)
2. **4K Resolution** - 3840x2160 pixels
3. **1440p QHD** - 2560x1440 pixels
4. **1080p Full HD** - 1920x1080 pixels
5. **720p HD** - 1280x720 pixels
6. **480p SD** - 854x480 pixels
7. **360p Mobile** - 480x360 pixels

Each quality tier includes direct CDN links for immediate download access.

***

### 🔧 Technical Features

#### 🖼️ Advanced Thumbnail Support

- Multiple resolution extraction (7 quality levels)
- Direct YouTube CDN access
- Maximum resolution detection
- Bulk thumbnail downloading

#### 📈 Metadata Extraction

- Complete video information capture
- Precise dimension measurements
- Upload date preservation
- Channel attribution data

#### ⚡ Reliability Features

- Direct CDN access for maximum reliability
- Comprehensive error handling
- URL validation and normalization
- Automatic quality fallback

***

### 💼 Use Cases

- **Content Creators** – Analyze thumbnail strategies and trends
- **SEO Specialists** – Optimize video metadata and thumbnails
- **Marketing Agencies** – Research competitor thumbnail designs
- **Data Analysts** – Study visual content patterns
- **App Developers** – Build thumbnail-powered applications
- **Researchers** – Analyze visual marketing trends

***

#### ✅ Why Choose Our YouTube Thumbnail Scraper & Downloader?

- **High Performance**: Fast and efficient thumbnail extraction process
- **User-Friendly**: Simple interface for beginners and professionals
- **Regular Updates**: Maintained for YouTube compatibility
- **Comprehensive Data**: Get all thumbnail resolutions and metadata
- **Bulk Processing**: Handle multiple videos simultaneously

***

#### ⚠️ Limitations

- Only works with public YouTube videos
- Thumbnail availability depends on YouTube's CDN
- The actor may encounter rate limits based on YouTube's restrictions

### 🔗🛠 Related Actors (Complete YouTube Suite)

Enhance your YouTube workflow with our comprehensive scraping tools:

#### 🎥 YouTube Scrapers:

- [YouTube Video Scraper](https://apify.com/codenest/youtube-video-scraper)
- [YouTube Video Transcript Scraper](https://apify.com/codenest/youtube-video-transcript-scraper)
- [YouTube Video Extractor](https://apify.com/codenest/youtube-video-extractor)
- [YouTube Video, Shorts & MP3/Audio Downloader](https://apify.com/codenest/youtube-video-shorts-mp3-audio-downloader)
- [YouTube  Mp3/Audio Downloader](https://apify.com/codenest/youtube-mp3-audio-downloader)
- [YouTube Video Downloader](https://apify.com/codenest/youtube-video-downloader)
- [YouTube Shorts Scraper & Downloader](https://apify.com/codenest/youtube-shorts-scraper-downloader)
- [YouTube Shorts Downloader](https://apify.com/codenest/youtube-shorts-downloader)
- [YouTube Image Post Scraper](https://apify.com/codenest/youtube-image-post-scraper)

#### 🎵 Facebook Scrapers:

- [Facebook Video Downloader](https://apify.com/codenest/facebook-video-downloader)
- [Facebook Reels Downloader](https://apify.com/codenest/facebook-reels-downloader)
- [Facebook Video Downloader](https://apify.com/codenest/facebook-video-downloader)

#### 🎵 TikTok Scrapers:

- [TikTok Video Scraper & Downloader](https://apify.com/codenest/tiktok-video-scraper-downloader)
- [TikTok Video Downloader](https://apify.com/codenest/tiktok-video-downloader)

#### 🎵 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 Image Downloader](https://apify.com/codenest/instagram-image-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 Thumbnail Scraper & Downloader](https://apify.com/codenest/instagram-reels-thumbnail-scraper-downloader)
- [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)

#### Linkedin Specialized Actors:

- [Linkedin Post Scraper](https://apify.com/codenest/linkedin-post-scraper)
- [Linkedin Profile Scraper](https://apify.com/codenest/linkedin-profile-scraper)
- [Linkedin Job Search Scraper](https://apify.com/codenest/linkedin-job-search-scraper)
- [Linkedin Company Scraper](https://apify.com/codenest/linkedin-company-scraper)

#### Twitch TV Scrapers:

- [Twitch TV Scraper](https://apify.com/codenest/twitch-tv-scraper)

#### Dailymotion Scrapers:

- [Dailymotion Video Downloader](https://apify.com/codenest/dailymotion-video-downloader)

#### Threads Scrapers:

- [Threads Post Downloader](https://apify.com/codenest/threads-post-downloader)

#### Spotify Scrapers:

- [Spotify Track Music Downloader](https://apify.com/codenest/spotify-track-music-downloader)
- [Spotify Music/Mp3 Downloader](https://apify.com/codenest/spotify-music-mp3-downloader)

#### Tumblr Scrapers:

- [Tumblr Media Scraper](https://apify.com/codenest/tumblr-media-scraper)

#### Loom Scrapers:

- [Loom Video Downloader](https://apify.com/codenest/loom-video-downloader)

#### VK Scrapers:

- [VK Video Downloader](https://apify.com/codenest/vk-video-downloader)

#### OK.ru Scrapers:

- [OK.ru Video Downloader](https://apify.com/codenest/ok-ru-video-downloader)

#### IFunny Scrapers:

- [IFunny Picture/Image Downloader](https://apify.com/codenest/ifunnypicturedownloader)
- [IFunny Video Downloader](https://apify.com/codenest/ifunny-video-downloader)

#### 9GAG Scrapers:

- [9GAG Post Downloader(Video & Image)](https://apify.com/codenest/9gag-post-downloader-video-image)

***

### 📧 Need Customization?

Want \*higher volume processing, \*\*additional metadata fields, or \**custom resolution outputs*?

✉ Email *<codenest2.0@gmail.com>* for tailored **YouTube Thumbnail Scraper & Downloader** solutions!

***

# Actor input Schema

## `video_urls` (type: `array`):

List of YouTube video, Shorts, or Kids URLs.

## `useKvStore` (type: `boolean`):

When enabled, audio files are downloaded through the proxy and stored in Apify KV Store, producing public URLs that never expire with 403. Slower but more reliable. When disabled, returns direct YouTube URLs (faster but may give 403 from your IP).

## Actor input object example

```json
{
  "video_urls": [
    {
      "url": "https://www.youtube.com/watch?v=cmGo8hM_nhs"
    },
    {
      "url": "https://youtube.com/shorts/5GlgIRLQ96g"
    },
    {
      "url": "https://www.youtubekids.com/watch?v=k85mRPqvMbE"
    }
  ],
  "useKvStore": false
}
```

# 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 = {
    "video_urls": [
        {
            "url": "https://www.youtube.com/watch?v=cmGo8hM_nhs"
        },
        {
            "url": "https://youtube.com/shorts/5GlgIRLQ96g"
        },
        {
            "url": "https://www.youtubekids.com/watch?v=k85mRPqvMbE"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("codenest/youtube-thumbnail-scraper-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 = { "video_urls": [
        { "url": "https://www.youtube.com/watch?v=cmGo8hM_nhs" },
        { "url": "https://youtube.com/shorts/5GlgIRLQ96g" },
        { "url": "https://www.youtubekids.com/watch?v=k85mRPqvMbE" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("codenest/youtube-thumbnail-scraper-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 '{
  "video_urls": [
    {
      "url": "https://www.youtube.com/watch?v=cmGo8hM_nhs"
    },
    {
      "url": "https://youtube.com/shorts/5GlgIRLQ96g"
    },
    {
      "url": "https://www.youtubekids.com/watch?v=k85mRPqvMbE"
    }
  ]
}' |
apify call codenest/youtube-thumbnail-scraper-downloader --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=codenest/youtube-thumbnail-scraper-downloader",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/gLdh4fh3Q9Rqcmqdf/builds/hKsG8l6sHx8K7DYEd/openapi.json