Pricing

Pay per usage

Youtube Thumbnail Downloader Free

Free YouTube thumbnail downloader — download high-quality thumbnails from any YouTube video. Supports HD (1280x720), SD, and all standard resolutions. Works with watch, shorts, and share links.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Epic Scrapers

Actor stats

Bookmarked

Total users

Monthly active users

3 days ago

Last modified

Dockerfile

# Read more about available images at
# https://docs.apify.com/sdk/js/docs/guides/docker-images
FROM apify/actor-node:24

# Copy just package.json and package-lock.json to speed up builds
COPY --chown=myuser:myuser package*.json ./

# Install NPM packages, skip optional and dev dependencies
RUN npm --quiet set progress=false \
    && npm install --omit=dev --omit=optional \
    && echo "Installed NPM packages:" \
    && (npm list --omit=dev --all || true) \
    && echo "Node.js version:" \
    && node --version \
    && echo "NPM version:" \
    && npm --version \
    && rm -r ~/.npm

# Copy the rest of the source code
COPY --chown=myuser:myuser . ./

# Start via npm start

SCHEMA.md

1# YouTube Thumbnail Downloader — Input/Output Schema
2
3This document describes the design of the actor's input and output. It is a
4design document, not the actual `.actor/input_schema.json` / output schema —
5those will be generated from this spec once the actor is implemented.
6
7---
8
9## Input
10
11The actor accepts a single `startUrls`-style input: a list of YouTube video
12URLs. For each URL, the actor fetches the requested thumbnail resolution(s)
13and saves the image(s) to the default Key-Value Store. One dataset item is
14produced per (video × resolution) pair.
15
16### Input fields
17
18| Field            | Type           | Required | Default | Description |
19|------------------|----------------|----------|---------|-------------|
20| `startUrls`      | `string[]`     | yes      | —       | List of YouTube watch / share / shorts URLs. Each URL is parsed to a video ID via regex. Invalid entries are skipped and reported in the run log. |
21| `resolutions`    | `string[]`     | no       | `["maxresdefault"]` | Which thumbnail qualities to download. Allowed values: `maxresdefault` (1280×720), `sddefault` (640×480), `hqdefault` (480×360), `mqdefault` (320×180), `default` (120×90). Unknown values are ignored. |
22| `filenamePrefix` | `string`       | no       | `"youtube-thumbnail-"` | Prefix for filenames saved in the KV-store. Final filename: `<prefix><videoId>_<resolution>.jpg` |
23| `proxy`          | `object`       | no       | —       | Optional Apify proxy config. Useful if YouTube throttles the actor IP during large runs. |
24
25### Example input
26
27```json
28{
29  "startUrls": [
30    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
31    "https://youtu.be/9bZkp7q19f0",
32    "https://www.youtube.com/shorts/jNQXAC9IVRw"
33  ],
34  "resolutions": [
35    "maxresdefault",
36    "sddefault"
37  ],
38  "filenamePrefix": "yt-thumb-"
39}
40```
41
42### URL parsing rules
43
44Accept any URL that contains an 11-character YouTube video ID. Patterns that
45must be handled:
46
47- `https://www.youtube.com/watch?v=<ID>`
48- `https://m.youtube.com/watch?v=<ID>`
49- `https://youtu.be/<ID>`
50- `https://www.youtube.com/shorts/<ID>`
51- `https://www.youtube.com/embed/<ID>`
52
53Anything that doesn't match is logged at `warning` level and skipped — it does
54not fail the run.
55
56### Resolution notes
57
58- `maxresdefault` may be missing for older videos. The actor should fall back
59  to `hqdefault` in that case and record the actually-served resolution in
60  the output.
61- All thumbnail URLs are public on `img.youtube.com`, so no scraping of the
62  watch page is required — we can construct the CDN URL directly from the
63  video ID.
64
65---
66
67## Output
68
69The actor writes to two places:
70
711. **Default Key-Value Store** — the actual image files, one per
72   (video × resolution) pair. Filename: `<filenamePrefix><videoId>_<resolution>.<ext>` where the extension matches the served content (`.jpg` for JPEG, `.webp` for WebP).
732. **Default Dataset** — one JSON item per saved image, described below.
74
75### Dataset item shape
76
77| Field              | Type     | Description |
78|--------------------|----------|-------------|
79| `videoId`          | `string` | The 11-character YouTube video ID extracted from the input URL. |
80| `sourceUrl`        | `string` | The original input URL the user provided (verbatim, for traceability). |
81| `title`            | `string` | Best-effort video title. Empty string if it could not be looked up. (Optional enrichment — see below.) |
82| `channelTitle`     | `string` | Best-effort channel name. Empty string if unavailable. |
83| `resolution`       | `string` | The requested resolution key (`maxresdefault`, `sddefault`, …). |
84| `resolutionServed` | `string` | The resolution actually fetched — may differ from `resolution` if we fell back from `maxresdefault` to `hqdefault`. |
85| `thumbnailUrl`     | `string` | The `img.youtube.com` URL the image was downloaded from. |
86| `width`            | `number` | Pixel width of the saved image. |
87| `height`           | `number` | Pixel height of the saved image. |
88| `bytes`            | `number` | File size in bytes. |
89| `contentType`      | `string` | MIME type of the saved image — `image/jpeg` (default) or `image/webp` when YouTube serves WebP only for that resolution. |
90| `keyValueStoreKey` | `string` | The filename in the default KV-store. Extension matches `contentType`: `.jpg` for JPEG, `.webp` for WebP (e.g. `yt-thumb-dQw4w9WgXcQ_maxresdefault.jpg`). |
91| `publicDownloadUrl`| `string` | A URL the user can click to download/view the image. |
92| `fetchedAt`        | `string` | ISO-8601 timestamp of when the image was downloaded. |
93
94### Example output (one row per saved image)
95
96```json
97[
98  {
99    "videoId": "dQw4w9WgXcQ",
100    "sourceUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
101    "title": "Rick Astley - Never Gonna Give You Up",
102    "channelTitle": "Rick Astley",
103    "resolution": "maxresdefault",
104    "resolutionServed": "maxresdefault",
105    "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
106    "width": 1280,
107    "height": 720,
108    "bytes": 112834,
109    "contentType": "image/jpeg",
110    "keyValueStoreKey": "yt-thumb-dQw4w9WgXcQ_maxresdefault.jpg",
111    "publicDownloadUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/yt-thumb-dQw4w9WgXcQ_maxresdefault.jpg",
112    "fetchedAt": "2026-06-19T20:35:12.000Z"
113  },
114  {
115    "videoId": "dQw4w9WgXcQ",
116    "sourceUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
117    "title": "Rick Astley - Never Gonna Give You Up",
118    "channelTitle": "Rick Astley",
119    "resolution": "sddefault",
120    "resolutionServed": "sddefault",
121    "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg",
122    "width": 640,
123    "height": 480,
124    "bytes": 54210,
125    "keyValueStoreKey": "yt-thumb-dQw4w9WgXcQ_sddefault.jpg",
126    "publicDownloadUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/yt-thumb-dQw4w9WgXcQ_sddefault.jpg",
127    "fetchedAt": "2026-06-19T20:35:13.000Z"
128  }
129]
130```
131
132### Title / channel enrichment (optional)
133
134Pulling the video title and channel name requires either scraping the watch
135page or using the YouTube Data API. To keep the actor dependency-free and
136free of API-key requirements, **enrichment is off by default**. If we add
137it later, the input will gain an optional `enrich: boolean` flag (default
138`false`) and an optional `youtubeApiKey` field. The output schema already
139accommodates this — those fields default to `""` when enrichment is off.
140
141---
142
143## Edge cases / behavior
144
145- **Duplicate resolutions in input** — de-duplicated before fetching.
146- **Invalid URL** — logged, skipped, run continues.
147- **`maxresdefault` returns 404** — fall back to `hqdefault`; record the
148  actual `resolutionServed` in the output.
149- **Empty `startUrls`** — actor exits cleanly with a warning, no items
150  pushed to the dataset, no files written.
151- **Network error mid-download** — logged, that (video × resolution) pair is
152  skipped, run continues.

.npmrc

min-release-age=1

.editorconfig

root = true

[*]
indent_style = space
indent_size = 4
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
end_of_line = lf
quote_type = single

seo-deconstruction.md

1# SEO Deconstruction — YouTube Thumbnail Downloader
2
3## Top-ranking Non-Apify Competitors
4
5### 1. youtube-thumbnail-scraper.com (Free web tool)
6**Why it ranks:**
7- Exact match domain name
8- Zero-friction experience: paste URL → get thumbnail, no registration
9- Lists multiple resolution options clearly
10- Simple, fast, minimal UI
11- No ads or clutter
12- Strong backlinks from tutorial/blog sites
13
14### 2. youtube-thumbnail-grabber.com
15**Why it ranks:**
16- Also an exact match domain
17- Supports both YouTube and Vimeo (broader utility)
18- Free, no login
19- Clean single-purpose landing page
20- Long-standing domain age
21
22### 3. Thunderbit Chrome Extension
23**Why it ranks:**
24- Chrome Web Store placement (Google product authority)
25- Extension format = always available in browser toolbar
26- Integrates with Sheets/Airtable/Notion (workflow value)
27- "AI-powered" keyword
28- 5-star rating signal
29
30### 4. Chrome Extension (YouTube Thumbnail Scraper)
31**Why it ranks:**
32- Chrome Web Store authority
33- Extracts ALL thumbnails from a page, not just one-by-one
34- Bulk CSV export
35- Auto-scroll for long pages
36- Privacy-focused marketing (no accounts, no tracking)
37- Open source (trust signal)
38
39## Top-ranking Apify Competitors
40
41### 1. alpha-scraper/youtube-thumbnails-downloader-or-scraper
42**Why it likely ranks:**
43- Broad keyword coverage in title/description
44- Multiple resolution quality mentions (8K to 360p)
45- Supports shorts, kids videos
46- Lists ALL URL formats
47- Falls back gracefully
48- Has many related actors (cross-linking SEO)
49- Long descriptions with keyword density
50
51### 2. codenest/youtube-thumbnail-scraper-downloader
52**Why it likely ranks:**
53- Professional-looking README with emoji headers
54- "8K" keyword (high-volume search term)
55- Proxy support mention (enterprise signal)
56- Many related actors (internal linking)
57- Clean, structured output documentation
58- Strong use case section
59
60### 3. parsebird/youtube-thumbnail-downloader
61**Why it likely ranks:**
62- Cheap pricing ($3/1000) prominently displayed
63- Specific technical detail (placeholder detection via response size)
64- No browser overhead (speed/cost advantage)
65- KV store integration for direct download
66- Comprehensive FAQ section
67- Clean, minimal README structure
68- API-first approach (developer audience)
69
70### 4. xscapeco/youtube-stats-and-thumbnail-download
71**Why it likely ranks:**
72- Uses official YouTube Data API (reliability signal)
73- Returns rich metadata (stats, channel info, subs)
74- Additional value beyond just thumbnails
75- Python-based (developer trust)
76
77## Key Takeaways for Our README
78
791. **Price prominently**: $3/1000 thumbnails is the market rate. Match or beat it.
802. **Resolution range**: Must mention maxresdefault (1280×720) up through all fallbacks.
813. **URL format support**: Explicitly list watch, youtu.be, shorts, embed, /v/.
824. **Technical differentiators**: Placeholder detection, no-browser architecture, KV store.
835. **Metadata enrichment**: Video title + channel title sets us apart from competitors that just return URLs.
846. **Competitive table**: Compare specifically against alpha-scraper, codenest, parsebird, and xscapeco.
857. **SEO keywords**: Cover "youtube thumbnail downloader", "bulk thumbnail download", "maxresdefault", "HD thumbnail extractor", "Apify YouTube actor", etc.
868. **Emoji headers**: All competitors use them — standard Apify Store convention.

.dockerignore

# configurations
.idea
.vscode
.zed

# crawlee and apify storage folders
apify_storage
crawlee_storage
storage

# installed files
node_modules

# git folder
.git

.gitignore

# This file tells Git which files shouldn't be added to source control

.DS_Store
.idea
.vscode
.zed
node_modules
storage

# Added by Apify CLI
.venv

package.json

{
	"name": "youtube-thumbnail-downloader",
	"version": "0.0.1",
	"type": "module",
	"description": "This is a boilerplate of an Apify Actor.",
	"engines": {
		"node": ">=18.0.0"
	},
	"dependencies": {
		"apify": "^3.7.0"
	},
	"devDependencies": {
		"@apify/eslint-config": "^2.0.0",
		"eslint": "^9.29.0",
		"eslint-config-prettier": "^10.1.5",
		"prettier": "^3.5.3",
		"vitest": "^4.1.0"
	},
	"scripts": {
		"start": "node ./src/main.js",
		"format": "prettier --write .",
		"format:check": "prettier --check .",
		"lint": "eslint",
		"lint:fix": "eslint --fix",
		"test": "vitest run"
	},
	"author": "It's not you it's me",
	"license": "ISC"
}

.prettierrc

{
    "printWidth": 120,
    "tabWidth": 4,
    "singleQuote": true
}

eslint.config.mjs

1import prettier from 'eslint-config-prettier';
2
3import apify from '@apify/eslint-config/js.js';
4
5// eslint-disable-next-line import-x/no-default-export
6export default [{ ignores: ['**/dist'] }, ...apify, prettier];

test/main.test.js

1import { describe, expect, it } from 'vitest';
2
3describe('Example test', () => {
4    it('works', () => {
5        expect(1 + 1).toBe(2);
6    });
7});

.actor/input_schema.json

{
    "title": "YouTube Thumbnail Downloader — Input",
    "description": "Download YouTube video thumbnails at various resolutions. Provide one or more YouTube video URLs (watch, share, shorts, embed) and select which thumbnail qualities to fetch. Images are saved to the default key-value store.",
    "type": "object",
    "schemaVersion": 1,
    "properties": {
        "startUrls": {
            "title": "YouTube video URLs",
            "type": "array",
            "description": "One or more YouTube video URLs. Supports standard watch URLs (youtube.com/watch?v=), shortened links (youtu.be/), shorts, and embed URLs. Invalid entries are skipped and logged.",
            "editor": "requestListSources",
            "prefill": [{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }]
        },
        "resolutions": {
            "sectionCaption": "Thumbnail settings",
            "title": "Thumbnail resolutions",
            "type": "array",
            "description": "Which thumbnail qualities to download. Unknown values are ignored. If a requested resolution is not available for a video (e.g. maxresdefault on older videos), that resolution is skipped — request multiple resolutions to get whichever are available.",
            "editor": "select",
            "default": ["maxresdefault"],
            "items": {
                "type": "string",
                "enum": ["maxresdefault", "sddefault", "hqdefault", "mqdefault", "default"],
                "enumTitles": [
                    "Max Resolution (1280×720)",
                    "SD (640×480)",
                    "HQ (480×360)",
                    "Medium (320×180)",
                    "Default (120×90)"
                ]
            },
            "uniqueItems": true,
            "minItems": 1
        },
        "filenamePrefix": {
            "title": "Filename prefix",
            "type": "string",
            "description": "Prefix for filenames saved in the key-value store. Final format: <prefix><videoId>_<resolution>.jpg",
            "editor": "textfield",
            "default": "youtube-thumbnail-",
            "prefill": "youtube-thumbnail-"
        }
    },
    "required": ["startUrls"]
}

.actor/actor.json

{
	"$schema": "https://apify.com/schemas/v1/actor.ide.json",
	"actorSpecification": 1,
	"name": "youtube-thumbnail-downloader",
	"title": "YouTube Thumbnail Downloader",
	"description": "Download YouTube video thumbnails at multiple resolutions. Accepts watch, share, shorts, and embed URLs. Saves images to key-value store and produces a dataset with metadata.",
	"version": "0.0",
	"buildTag": "latest",
	"meta": {
		"templateId": "js-empty"
	},
	"dockerfile": "../Dockerfile",
	"input": "./input_schema.json",
	"output": "./output_schema.json",
	"storages": {
		"dataset": "./dataset_schema.json"
	}
}

.actor/output_schema.json

{
    "actorOutputSchemaVersion": 1,
    "title": "YouTube Thumbnail Downloader — Output",
    "description": "Downloaded YouTube thumbnails. Images are stored in the default key-value store. Metadata (video ID, resolution, dimensions, etc.) is available in the default dataset.",
    "type": "object",
    "properties": {
        "thumbnails": {
            "type": "string",
            "title": "Thumbnail images",
            "description": "Downloaded thumbnail images stored in the default key-value store. Each file is named <prefix><videoId>_<resolution>.jpg.",
            "template": "{{links.apiDefaultKeyValueStoreUrl}}/keys"
        },
        "metadata": {
            "type": "string",
            "title": "Dataset metadata",
            "description": "One dataset item per saved thumbnail with video ID, resolution served, dimensions, file size, content type, and download URL.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
        }
    }
}

.actor/dataset_schema.json

{
    "actorSpecification": 1,
    "fields": {
        "type": "object",
        "properties": {
            "videoId": {
                "type": "string",
                "title": "Video ID",
                "description": "The 11-character YouTube video ID extracted from the input URL.",
                "example": "dQw4w9WgXcQ"
            },
            "sourceUrl": {
                "type": "string",
                "title": "Source URL",
                "description": "The original input URL the user provided.",
                "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
            },
            "resolution": {
                "type": "string",
                "title": "Resolution",
                "description": "The thumbnail resolution key fetched from YouTube's CDN.",
                "example": "maxresdefault",
                "enum": ["maxresdefault", "sddefault", "hqdefault", "mqdefault", "default"]
            },
            "thumbnailUrl": {
                "type": "string",
                "title": "Thumbnail URL",
                "description": "The i.ytimg.com CDN URL the image was downloaded from.",
                "example": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
            },
            "width": {
                "type": "integer",
                "title": "Width (px)",
                "description": "Pixel width of the saved image.",
                "example": 1280,
                "minimum": 1
            },
            "height": {
                "type": "integer",
                "title": "Height (px)",
                "description": "Pixel height of the saved image.",
                "example": 720,
                "minimum": 1
            },
            "bytes": {
                "type": "integer",
                "title": "File size (bytes)",
                "description": "File size of the saved image in bytes.",
                "example": 65324,
                "minimum": 1
            },
            "contentType": {
                "type": "string",
                "title": "Content type",
                "description": "MIME type of the saved image (always image/jpeg).",
                "example": "image/jpeg",
                "enum": ["image/jpeg"]
            },
            "keyValueStoreKey": {
                "type": "string",
                "title": "KV-store filename",
                "description": "The filename in the default key-value store (.jpg).",
                "example": "youtube-thumbnail-dQw4w9WgXcQ_maxresdefault.jpg"
            },
            "publicDownloadUrl": {
                "type": "string",
                "title": "Download URL",
                "description": "A public URL to download or view the image from the key-value store.",
                "example": "https://api.apify.com/v2/key-value-stores/<storeId>/records/youtube-thumbnail-dQw4w9WgXcQ_maxresdefault.jpg"
            },
            "fetchedAt": {
                "type": "string",
                "title": "Fetch timestamp",
                "description": "ISO-8601 timestamp of when the image was downloaded.",
                "example": "2026-06-22T08:26:59.755Z"
            }
        },
        "required": [
            "videoId",
            "sourceUrl",
            "resolution",
            "thumbnailUrl",
            "width",
            "height",
            "bytes",
            "contentType",
            "keyValueStoreKey",
            "publicDownloadUrl",
            "fetchedAt"
        ]
    },
    "views": {
        "overview": {
            "title": "Overview",
            "transformation": {
                "fields": [
                    "videoId",
                    "sourceUrl",
                    "resolution",
                    "width",
                    "height",
                    "bytes",
                    "contentType",
                    "thumbnailUrl",
                    "publicDownloadUrl",
                    "fetchedAt"
                ]
            },
            "display": {
                "component": "table",
                "properties": {
                    "videoId": {
                        "label": "Video ID"
                    },
                    "sourceUrl": {
                        "label": "Source URL",
                        "format": "link"
                    },
                    "resolution": {
                        "label": "Res."
                    },
                    "width": {
                        "label": "Width",
                        "format": "number"
                    },
                    "height": {
                        "label": "Height",
                        "format": "number"
                    },
                    "bytes": {
                        "label": "Size (bytes)",
                        "format": "number"
                    },
                    "contentType": {
                        "label": "Type"
                    },
                    "thumbnailUrl": {
                        "label": "Thumbnail URL",
                        "format": "link"
                    },
                    "publicDownloadUrl": {
                        "label": "Download",
                        "format": "link"
                    },
                    "fetchedAt": {
                        "label": "Fetched at",
                        "format": "date"
                    }
                }
            }
        }
    }
}

assets/banner.svg

1<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="400" viewBox="0 0 1600 400">
2  <rect width="1600" height="400" fill="#FF0034" rx="12"/>
3
4  <!-- Play icon -->
5  <g transform="translate(100, 155)">
6    <rect x="0" y="0" width="120" height="90" rx="20" fill="#FFF"/>
7    <polygon points="48,22 48,68 82,45" fill="#FF0034"/>
8  </g>
9
10  <!-- Headline -->
11  <text x="260" y="200" font-family="Arial, Helvetica, sans-serif" font-size="60" font-weight="900" fill="#FFFFFF">
12    YouTube Thumbnail Downloader
13  </text>
14
15  <text x="260" y="250" font-family="Arial, Helvetica, sans-serif" font-size="22" fill="#FFFFFF" opacity="0.85">
16    Paste URLs. Pick resolution. Download in bulk.
17  </text>
18</svg>

src/main.js

1import { Actor, log } from 'apify';
2
3// YouTube serves each thumbnail resolution key at a fixed size from its CDN,
4// so dimensions are known up front -- no image-header parsing needed.
5const RESOLUTIONS = {
6    maxresdefault: { width: 1280, height: 720 },
7    sddefault: { width: 640, height: 480 },
8    hqdefault: { width: 480, height: 360 },
9    mqdefault: { width: 320, height: 180 },
10    default: { width: 120, height: 90 },
11};
12
13const ALLOWED_RES = Object.keys(RESOLUTIONS);
14
15// Matches the 11-char video ID in any common YouTube URL form:
16// watch?v=, youtu.be/, shorts/, embed/, legacy /v/.
17const VIDEO_ID_RE = /(?:v=|\/shorts\/|\/embed\/|\/v\/|\/youtu\.be\/)([A-Za-z0-9_-]{11})/;
18
19// YouTube returns a ~1 KB grey placeholder JPEG for missing thumbnails.
20const PLACEHOLDER_MAX_BYTES = 1500;
21
22function parseVideoId(item) {
23    const raw = typeof item === 'string' ? item : item?.url;
24    if (!raw) return null;
25    const match = String(raw).match(VIDEO_ID_RE);
26    return match ? match[1] : null;
27}
28
29function sourceUrlOf(item) {
30    return typeof item === 'string' ? item : (item?.url ?? '');
31}
32
33function normalizeResolutions(input) {
34    const wanted = [...new Set((input ?? []).filter((r) => ALLOWED_RES.includes(r)))];
35    if (wanted.length === 0) {
36        log.warning('No valid resolutions provided, defaulting to maxresdefault.');
37        wanted.push('maxresdefault');
38    }
39    return wanted;
40}
41
42async function fetchThumbnail(videoId, resolution) {
43    const url = `https://i.ytimg.com/vi/${videoId}/${resolution}.jpg`;
44    const res = await fetch(url);
45    if (!res.ok) return null;
46    const buf = Buffer.from(await res.arrayBuffer());
47    if (buf.length < PLACEHOLDER_MAX_BYTES) return null; // placeholder
48    return { url, buf };
49}
50
51async function main() {
52    await Actor.init();
53
54    const input = (await Actor.getInput()) ?? {};
55    const { startUrls = [], resolutions = ['maxresdefault'], filenamePrefix = 'youtube-thumbnail-' } = input;
56
57    const wantedRes = normalizeResolutions(resolutions);
58    log.info(`Resolutions: ${wantedRes.join(', ')}`);
59
60    const videos = [];
61    for (const item of startUrls) {
62        const id = parseVideoId(item);
63        if (id) videos.push({ id, sourceUrl: sourceUrlOf(item) });
64        else log.warning(`Skipping unrecognised URL: ${sourceUrlOf(item) || item}`);
65    }
66
67    if (videos.length === 0) {
68        log.warning('No valid YouTube URLs in startUrls, exiting.');
69        return;
70    }
71
72    log.info(`Processing ${videos.length} video(s).`);
73    const store = await Actor.openKeyValueStore();
74
75    for (const { id: videoId, sourceUrl } of videos) {
76        for (const resolution of wantedRes) {
77            let fetched;
78            try {
79                fetched = await fetchThumbnail(videoId, resolution);
80            } catch (err) {
81                log.warning(`[${videoId}] ${resolution} fetch failed: ${err.message}`);
82                continue;
83            }
84            if (!fetched) {
85                log.info(`[${videoId}] ${resolution} not available, skipping.`);
86                continue;
87            }
88
89            const { url: thumbnailUrl, buf } = fetched;
90            const { width, height } = RESOLUTIONS[resolution];
91            const contentType = 'image/jpeg';
92            const kvKey = `${filenamePrefix}${videoId}_${resolution}.jpg`;
93
94            await Actor.setValue(kvKey, buf, { contentType });
95
96            await Actor.pushData({
97                videoId,
98                sourceUrl,
99                resolution,
100                thumbnailUrl,
101                width,
102                height,
103                bytes: buf.length,
104                contentType,
105                keyValueStoreKey: kvKey,
106                publicDownloadUrl: `https://api.apify.com/v2/key-value-stores/${store.storeId}/records/${kvKey}`,
107                fetchedAt: new Date().toISOString(),
108            });
109
110            log.info(`[${videoId}] Saved ${resolution} (${width}x${height}, ${buf.length} bytes).`);
111        }
112    }
113}
114
115try {
116    await main();
117} finally {
118    await Actor.exit();
119}

.github/workflows/test.yaml

name: CI

on:
    pull_request:
    push:
        branches: [main, master]

jobs:
    test:
        runs-on: ubuntu-latest
        steps:
            - uses: actions/checkout@v6
            - uses: actions/setup-node@v6
              with:
                  node-version: 24
                  cache: npm
            - run: npm ci
            - run: npm test

YouTube Thumbnail Downloader

parsebird/youtube-thumbnail-downloader

Download YouTube video thumbnails in bulk — HD, SD, or custom quality with automatic fallback. Supports all URL formats: watch pages, Shorts, embeds, youtu.be links. No browser needed. Export thumbnail metadata as JSON, CSV, Excel, or download images directly.

ParseBird

YouTube Thumbnail Scraper & Downloader

codenest/youtube-thumbnail-scraper-downloader

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.

CodeNest

Youtube-video-downloader

youtube.video.downloader/youtube-video-downloader

A Best Fast Free Youtube Video Downloader API.

Youtube Downloader

Youtube Video Downloader

thenetaji/youtube-video-downloader

Download YouTube videos quickly and in high quality with our YouTube Video Downloader. This easy-to-use tool allows you to save YouTube videos in multiple formats and resolutions. Perfect for content creators, marketers, and researchers, our downloader supports fast, secure, and hassle-free.Try now!

The Netaji

605

3.4

Youtube Video Downloader API

igview-owner/youtube-video-downloader-api

Download YouTube videos and audio in multiple formats and qualities. Extract video metadata, thumbnails, captions, and direct download links. Supports regular videos and YouTube Shorts with high-quality output.

Sachin Kumar Yadav

104

Youtube Scraper - Video & Shorts Downloader

saswave/youtube-scraper-video-downloader

Youtube scraper. Extract youtube video and shorts content informations. Collect youtube channel data. Download video file

SASWAVE

Youtube Downloader API

vivid_astronaut/youtube-downloader

Fabio Suizu

YouTube Shorts & Video Downloader

codenest/youtube-shorts-video-downloader

🚀Easily and fast download YouTube videos, shorts and Audio with direct CDN links! Get multiple resolutions (4k to 360p), separate audio streams, thumbnails, metadata, and quality options in MP4/WebM formats. Perfect for bulk downloading! 🎥YouTube Shorts & Video Downloader.

CodeNest

Youtube Shorts Downloader

apilabs/youtube-shorts-downloader

Download YouTube Shorts or extract audio without any limits

ApiLabs

YouTube Video Downloader

truefetch/youtube-video-downloader

Download YouTube videos in 4K, HD, or audio-only — Shorts, Music, and regular uploads. Returns captions, top comments, thumbnail URL, and video file. $0.25 per download.

TrueFetch

200

3.0

Youtube Thumbnail Downloader Free

Dockerfile

SCHEMA.md

.npmrc

.editorconfig

seo-deconstruction.md

.dockerignore

.gitignore

package.json

.prettierrc

eslint.config.mjs

test/main.test.js

.actor/input_schema.json

.actor/actor.json

.actor/output_schema.json

.actor/dataset_schema.json

assets/banner.svg

src/main.js

.github/workflows/test.yaml

You might also like

YouTube Thumbnail Downloader

YouTube Thumbnail Scraper & Downloader

Youtube-video-downloader

Youtube Video Downloader

Youtube Video Downloader API

Youtube Scraper - Video & Shorts Downloader

Youtube Downloader API

YouTube Shorts & Video Downloader

Youtube Shorts Downloader

YouTube Video Downloader

Dockerfile

SCHEMA.md

.npmrc

.editorconfig

seo-deconstruction.md

.dockerignore

.gitignore

package.json

.prettierrc

eslint.config.mjs

test/main.test.js

.actor/input_schema.json

.actor/actor.json

.actor/output_schema.json

.actor/dataset_schema.json

assets/banner.svg

src/main.js

.github/workflows/test.yaml