Pricing

$2.70 / 1,000 thumbnails

Try for free

Go to Apify Store

YouTube Thumbnail Downloader

Try for free

Get direct public YouTube thumbnail links from a list of video URLs or IDs. Choose the requested quality, see pixel dimensions, and optionally include video context or other available quality links. Unavailable items are reported while the run continues.

Pricing

$2.70 / 1,000 thumbnails

Rating

0.0

(0)

Developer

Maxime Dupré

Actor stats

Bookmarked

Total users

Monthly active users

6 days ago

Last modified

Categories

Social media

Developer tools

Automation

You can access the YouTube Thumbnail Downloader programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "gfb6gzjurFOBh2sYa"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/maximedupre~youtube-thumbnails/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-maximedupre-youtube-thumbnails",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/maximedupre~youtube-thumbnails/runs": {
      "post": {
        "operationId": "runs-sync-maximedupre-youtube-thumbnails",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/maximedupre~youtube-thumbnails/run-sync": {
      "post": {
        "operationId": "run-sync-maximedupre-youtube-thumbnails",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "videoReferences"
        ],
        "properties": {
          "videoReferences": {
            "title": "YouTube video references",
            "minItems": 1,
            "type": "array",
            "description": "Add one or more public YouTube video links or bare video IDs. Common watch, short-link, Shorts, embed, live, legacy, and YouTube Kids links are accepted when they resolve to a video.",
            "items": {
              "type": "string"
            }
          },
          "quality": {
            "title": "Thumbnail quality",
            "enum": [
              "maxresdefault",
              "sddefault",
              "hqdefault",
              "mqdefault",
              "default"
            ],
            "type": "string",
            "description": "Choose the thumbnail quality to request. If it is not available, the item fails unless quality fallback is on.",
            "default": "hqdefault"
          },
          "allowQualityFallback": {
            "title": "Allow quality fallback",
            "type": "boolean",
            "description": "When on, use a lower quality if the requested quality is not available. The result reports the quality that was delivered.",
            "default": false
          },
          "includeVideoContext": {
            "title": "Include video context",
            "type": "boolean",
            "description": "When on, add the public video title, channel, and publication date to each result.",
            "default": false
          },
          "includeAvailableQualities": {
            "title": "Include other quality links",
            "type": "boolean",
            "description": "When on, add direct links for other available thumbnail qualities along with the selected quality.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

YouTube Thumbnail Download and Size Data OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for YouTube Thumbnail Downloader from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

YouTube Thumbnail Downloader API in Python

YouTube Thumbnail Downloader API in JavaScript

YouTube Thumbnail Downloader API through CLI

YouTube Thumbnail Downloader API

Video Thumbnail API

vivid_astronaut/video-thumbnail

BRAINIALL Team

YouTube Thumbnail Scraper

intelscrape/youtube-thumbnail-scraper

YouTube Thumbnail Scraper Pro Instantly extract any YouTube thumbnail downloader pro in all 5 high-quality resolutions. This lightning-fast YouTube thumbnail scraper bypasses browsers for zero compute costs. Easily download YouTube thumbnails in bulk with premium video metadata built in

IntelScrape

YouTube Video Description Extractor

alpha-scraper/youtube-video-description-extractor

📺 collects public video descriptions and thumbnail URLs from one or multiple YouTube video links. Simply paste the URLs and get clean, structured metadata ready for analysis, research, and automation workflows.

Alpha Scraper

YouTube Shorts Downloader

maximedupre/youtube-shorts-downloader

Turn known public YouTube Shorts URLs into source media links and metadata. See the requested and available quality, formats, thumbnails, duration, channel data, and source pages.

Maxime Dupré

Video Thumbnail Extractor

happitap/video-thumbnail-extractor

Extract high-quality thumbnails from videos across multiple platforms including YouTube, Vimeo, direct video URLs, and more.

HappiTap

135

5.0

Youtube Thumbnail Downloader Free

epicscrapers/youtube-thumbnail-downloader

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.

Epic Scrapers

YouTube Thumbnail Downloader

automation-lab/youtube-thumbnail-downloader

Download public YouTube thumbnails in bulk with quality, image, and stored-asset metadata.

Stas Persiianenko

YouTube Video Metadata Scraper - Video Data

benthepythondev/youtube-video-metadata-scraper

Scrape metadata from YouTube video URLs: title, description, channel, views, likes, comments, duration, tags and thumbnail.

Ben

YouTube Video Scraper & Downloader

codenest/youtube-video-scraper-downloader

Easily extract comprehensive YouTube video and YouTube-kids video data including metadata, engagement analytics, multiple quality download links, channel information, and technical specifications for professional media workflows. So try it now. ❤️YouTube Video Scraper & Downloader.