Pricing

Pay per usage

Try for free

Go to Apify Store

Youtube Thumbnail Downloader Open Source

Try for free

Free Open Source 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

14 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 actor's input and output. Thumbnails are fetched
4directly from YouTube's public image CDN (`i.ytimg.com`) — no `yt-dlp`, no
5browser, no API key.
6
7---
8
9## Input
10
11The actor accepts a `startUrls`-style input: a list of YouTube video URLs.
12For each URL, it fetches the requested thumbnail resolution(s) and saves the
13image(s) to the default Key-Value Store. One dataset item is produced per
14(video × resolution) pair that was successfully downloaded.
15
16### Input fields
17
18| Field            | Type       | Required | Default                  | Description |
19|------------------|------------|----------|--------------------------|-------------|
20| `startUrls`      | `array`    | yes      | —                        | List of YouTube URLs (watch / share / shorts / embed / legacy `/v/`). Each entry is a `{ "url": "..." }` object (the Apify `requestListSources` editor format); plain strings are also accepted. Invalid entries are skipped and logged. |
21| `resolutions`    | `string[]` | no       | `["maxresdefault"]`      | Which thumbnail qualities to download. Allowed: `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
24### Example input
25
26```json
27{
28  "startUrls": [
29    { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
30    { "url": "https://youtu.be/9bZkp7q19f0" },
31    { "url": "https://www.youtube.com/shorts/jNQXAC9IVRw" }
32  ],
33  "resolutions": ["maxresdefault", "sddefault"],
34  "filenamePrefix": "yt-thumb-"
35}
36```
37
38### URL parsing rules
39
40The actor extracts the 11-character YouTube video ID with a single regex that
41matches the ID in any common URL form:
42
43- `https://www.youtube.com/watch?v=<ID>`
44- `https://m.youtube.com/watch?v=<ID>`
45- `https://youtu.be/<ID>`
46- `https://www.youtube.com/shorts/<ID>`
47- `https://www.youtube.com/embed/<ID>`
48- `https://www.youtube.com/v/<ID>` (legacy)
49
50Anything that does not match is logged at `warning` level and skipped — it does
51not fail the run.
52
53### Resolution notes
54
55- `maxresdefault` may be missing for older videos. There is **no automatic
56  fallback**: a missing resolution is simply skipped for that video. Request
57  multiple resolutions to get whichever are available.
58- All thumbnail URLs are public on `i.ytimg.com`, so no watch-page scraping is
59  needed — the CDN URL is constructed directly from the video ID.
60
61---
62
63## Output
64
65The actor writes to two places:
66
671. **Default Key-Value Store** — the actual image files, one per successfully
68   downloaded (video × resolution) pair. Filename:
69   `<filenamePrefix><videoId>_<resolution>.jpg`.
702. **Default Dataset** — one JSON item per saved image, described below.
71
72### Dataset item shape
73
74| Field              | Type     | Description |
75|--------------------|----------|-------------|
76| `videoId`          | `string` | The 11-character YouTube video ID extracted from the input URL. |
77| `sourceUrl`        | `string` | The original input URL the user provided (verbatim, for traceability). |
78| `resolution`       | `string` | The thumbnail resolution key fetched (`maxresdefault`, `sddefault`, `hqdefault`, `mqdefault`, `default`). |
79| `thumbnailUrl`     | `string` | The `i.ytimg.com` CDN URL the image was downloaded from. |
80| `width`            | `number` | Pixel width of the image (fixed per resolution key). |
81| `height`           | `number` | Pixel height of the image (fixed per resolution key). |
82| `bytes`            | `number` | File size of the saved image in bytes. |
83| `contentType`      | `string` | MIME type of the saved image — always `image/jpeg`. |
84| `keyValueStoreKey` | `string` | The filename in the default KV-store (e.g. `yt-thumb-dQw4w9WgXcQ_maxresdefault.jpg`). |
85| `publicDownloadUrl`| `string` | A URL the user can click to download/view the image. |
86| `fetchedAt`        | `string` | ISO-8601 timestamp of when the image was downloaded. |
87
88### Example output (one row per saved image)
89
90```json
91[
92  {
93    "videoId": "dQw4w9WgXcQ",
94    "sourceUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
95    "resolution": "maxresdefault",
96    "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
97    "width": 1280,
98    "height": 720,
99    "bytes": 65324,
100    "contentType": "image/jpeg",
101    "keyValueStoreKey": "yt-thumb-dQw4w9WgXcQ_maxresdefault.jpg",
102    "publicDownloadUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/yt-thumb-dQw4w9WgXcQ_maxresdefault.jpg",
103    "fetchedAt": "2026-06-22T08:26:59.755Z"
104  },
105  {
106    "videoId": "dQw4w9WgXcQ",
107    "sourceUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
108    "resolution": "sddefault",
109    "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg",
110    "width": 640,
111    "height": 480,
112    "bytes": 31029,
113    "contentType": "image/jpeg",
114    "keyValueStoreKey": "yt-thumb-dQw4w9WgXcQ_sddefault.jpg",
115    "publicDownloadUrl": "https://api.apify.com/v2/key-value-stores/<storeId>/records/yt-thumb-dQw4w9WgXcQ_sddefault.jpg",
116    "fetchedAt": "2026-06-22T08:26:59.760Z"
117  }
118]
119```
120
121---
122
123## Edge cases / behavior
124
125- **Duplicate resolutions in input** — de-duplicated before fetching.
126- **Invalid URL** — logged at `warning` level and skipped; the run continues.
127- **Requested resolution unavailable** — YouTube's CDN returns a ~1 KB grey
128  placeholder JPEG (HTTP 404). The actor detects this via response size and
129  skips that (video × resolution) pair. No dataset item is pushed for it; the
130  run continues. There is no automatic fallback — request multiple
131  resolutions if you want a guaranteed result.
132- **Empty `startUrls`** — the actor exits cleanly with a warning, no items are
133  pushed and no files are written.
134- **Network error mid-download** — logged at `warning` level; that
135  (video × resolution) pair is skipped and the run continues.
136- **`publicDownloadUrl` locally** — when running locally with `apify run`, the
137  key-value store has no remote ID, so `publicDownloadUrl` contains `undefined`
138  in place of the store ID. On the Apify platform the real store ID is used.

.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];

.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

{
  "actorSpecification": 1,
  "$schema": "https://apify.com/schemas/v1/actor.ide.json",
  "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",
  "dockerfile": "../Dockerfile",
  "meta": {
    "templateId": "js-empty"
  },
  "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"
                    }
                }
            }
        }
    }
}

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});

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 Channel Video Scraper

grow_media/youtube-channel-video-scraper

Extract videos from any YouTube channel using handle or ID. Scrape long-form videos and Shorts with sorting by latest, popular, or oldest. Get detailed metadata including views, likes, comments, duration, thumbnails, descriptions, and complete channel info. Export to JSON, CSV, Excel, or XML.

Grow Media

5.9K

Youtube Transcript Scraper - $0.7 per 1k

supreme_coder/youtube-transcript-scraper

Scrape youtube videos and transcripts in bulk from channels, youtube search, playlists, etc. Provides videos details and transcript in different formats

Supreme Coder

3.1K

5.0

(2)

YouTube Video Transcript

starvibe/youtube-video-transcript

This Apify Actor extracts full transcripts (with timestamps) and metadata from YouTube videos, including title, description, upload date, views, likes, channel info, and duration

starvibe

14K

5.0

(23)

Instagram Transcript API & Profile Scraper - AI Video to Text

apple_yang/instagram-transcripts-scraper

Instagram Reels Transcript API for converting video audio into structured text using AI. Extract transcripts, timestamped segments, media URLs, and metadata from public Reels and videos. Also supports public profile post scraping for creator research, competitor research, and automation workflows.

APISmith

3.3K

4.5

(13)

Fast YouTube Channel Scraper

streamers/youtube-channel-scraper

This alternative YouTube Data API has no limits or quotas. Use it to scrape one or multiple YouTube channels: channel info, URL, total number of subscribers, videos and views, creation date. Try it and get basic video data. You can download extracted data in JSON, CSV, and Excel.

Streamers

25K

4.7

(41)

YouTube Scraper

streamers/youtube-scraper

YouTube crawler and video scraper. Alternative YouTube API with no limits or quotas. Extract and download channel name, likes, number of views, and number of subscribers.

Streamers

169K

4.8

(196)

YouTube Music Downloader

maximedupre/youtube-music-downloader

Download audio from public YouTube Music tracks and YouTube videos as MP3, M4A, WebM, FLAC, WAV, Vorbis, or ALAC. Get a saved file link that works without an Apify login or exposed token, plus track data and optional captions.

Maxime Dupré

Youtube Shorts Downloader

easyapi/youtube-shorts-downloader

Extract and download YouTube Shorts videos in multiple formats and qualities. Get direct download links, video metadata, and audio streams. Perfect for content creators, researchers, and developers working with YouTube Shorts content. 🎥✨

EasyApi

274

5.0

(1)

Instagram Comments Scraper

apify/instagram-comment-scraper

Scrape Instagram comments from posts or reels. Just add one or more Instagram post URLs to get comment text, post and comment IDs, replies, timestamp, owner IDs, usernames, profile pics. Export scraped datasets, run the scraper via API, schedule and monitor runs or integrate with other tools.

Apify

62K

4.4

(69)

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 Thumbnail Downloader Open Source

Dockerfile

SCHEMA.md

.npmrc

.editorconfig

seo-deconstruction.md

.dockerignore

.gitignore

package.json

.prettierrc

eslint.config.mjs

.actor/input_schema.json

.actor/actor.json

.actor/output_schema.json

.actor/dataset_schema.json

test/main.test.js

assets/banner.svg

src/main.js

.github/workflows/test.yaml

You might also like

Youtube Channel Video Scraper

Youtube Transcript Scraper - $0.7 per 1k

YouTube Video Transcript

Instagram Transcript API & Profile Scraper - AI Video to Text

Fast YouTube Channel Scraper

YouTube Scraper

YouTube Music Downloader

Youtube Shorts Downloader

Instagram Comments Scraper

YouTube Thumbnail Scraper & Downloader

Dockerfile

SCHEMA.md

.npmrc

.editorconfig

seo-deconstruction.md

.dockerignore

.gitignore

package.json

.prettierrc

eslint.config.mjs

.actor/input_schema.json

.actor/actor.json

.actor/output_schema.json

.actor/dataset_schema.json

test/main.test.js

assets/banner.svg

src/main.js

.github/workflows/test.yaml