URL превью YouTube – все ссылки img.youtube.com с пояснениями

Каждое превью на YouTube лежит по предсказуемому адресу. Если вы знаете ID видео из 11 символов, ссылку можно собрать самостоятельно — без API-ключа.

Шаг 1: найдите ID видео

ID — это 11 символов после v=, youtu.be/ или /shorts/:

Шаг 2: соберите URL

https://i.ytimg.com/vi/ID_ВИДЕО/ИМЯ_ФАЙЛА.jpg

Старый домен img.youtube.com/vi/ID_ВИДЕО/ИМЯ_ФАЙЛА.jpg отдаёт те же изображения.

Все имена файлов

У некоторых видео есть также hq1.jpg–hq3.jpg, mq1.jpg–mq3.jpg и sd1.jpg–sd3.jpg — увеличенные версии автоматических кадров.

Версии WebP

Чтобы файлы были легче, замените vi на vi_webp, а .jpg на .webp:

https://i.ytimg.com/vi_webp/ID_ВИДЕО/maxresdefault.webp

Как использовать в HTML

Лёгкое превью «нажмите, чтобы смотреть», которое не загружает тяжёлый плеер YouTube до клика:

<a href="https://www.youtube.com/watch?v=ID_ВИДЕО">
  <img src="https://i.ytimg.com/vi/ID_ВИДЕО/hqdefault.jpg"
       width="480" height="360" loading="lazy"
       alt="Название видео">
</a>

Используйте hqdefault.jpg, если нужен адрес, который работает всегда; maxresdefault.jpg чётче, но отсутствует у старых видео в низком разрешении (см. почему иногда нет HD-превью).

Как определить отсутствующий размер в JavaScript

Если размера нет, YouTube возвращает заглушку 120 × 90. Проверьте ширину загруженного изображения:

const img = new Image();
img.onload = () => {
  const exists = img.naturalWidth > 120;
  console.log(exists ? 'HD есть' : 'HD нет');
};
img.src = `https://i.ytimg.com/vi/${id}/maxresdefault.jpg`;

Именно так наш загрузчик превью решает, какие размеры выделить серым.

Те же размеры в YouTube Data API и oEmbed

В YouTube Data API поле snippet.thumbnails возвращает те же файлы под другими именами:

Без API-ключа точка oEmbed от YouTube возвращает в JSON название, имя канала и thumbnail_url (всегда размера hqdefault.jpg):

https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=VIDEO_ID&format=json

Скачивание из командной строки

Одно превью:

curl -o thumb.jpg https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg

Много превью по списку ID в ids.txt, с запасным hqdefault, если HD-размера нет (-f заставляет curl остановиться на ошибке 404, а не сохранять заглушку):

while read id; do
  curl -sf -o "$id.jpg" "https://i.ytimg.com/vi/$id/maxresdefault.jpg" \
  || curl -s -o "$id.jpg" "https://i.ytimg.com/vi/$id/hqdefault.jpg"
done < ids.txt

Как получить свежую копию после смены превью

URL не меняется, когда автор загружает новое превью, поэтому браузер или CDN могут показывать старую картинку. Добавьте любой параметр, чтобы скачать заново: YouTube его игнорирует, а кеш считает это новым адресом:

https://i.ytimg.com/vi/VIDEO_ID/maxresdefault.jpg?v=2

Затем очистите кеш своего сайта или CDN — и новое изображение увидят все. Другие причины и решения — в статье превью YouTube не обновляется.