# youtube-thumbnail

> get thumbnail images for youtube videos

Latest version **1.4.0** (published 2026-08-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install youtube-thumbnail
pnpm add youtube-thumbnail
yarn add youtube-thumbnail
bun add youtube-thumbnail
```

Provides the command `youtube-thumbnail`.

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2026-08-29 |
| First published | 2015-02-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=0.10.0 |
| Dependencies | 1 |
| Unpacked size | 6.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | Matias Singers |
| Maintainers | matiassingers |
| Keywords | youtube, thumbnail |

## Links

- npm: https://www.npmjs.com/package/youtube-thumbnail
- Repository: https://github.com/matiassingers/youtube-thumbnail
- Issues: https://github.com/matiassingers/youtube-thumbnail/issues
- npm.io page: https://npm.io/package/youtube-thumbnail

## Dependencies (1)

- [get-youtube-id](https://npm.io/package/get-youtube-id.md) 0.1.3

## Alternatives

- [exif-parser](https://npm.io/package/exif-parser.md) — 3.8M weekly downloads
- [vite-plugin-compression](https://npm.io/package/vite-plugin-compression.md) — 569.5K weekly downloads
- [pica](https://npm.io/package/pica.md) — 442.4K weekly downloads
- [@reportportal/client-javascript](https://npm.io/package/@reportportal/client-javascript.md) — 408.8K weekly downloads
- [@tldraw/state](https://npm.io/package/@tldraw/state.md) — 316.0K weekly downloads

## Recent versions

- 1.4.0 (latest) — 2026-08-29
- 1.3.0 — 2015-06-03
- 1.2.0 — 2015-04-06
- 1.1.0 — 2015-02-02
- 1.0.0 — 2015-02-02

## README

# youtube-thumbnail [![Build Status](http://img.shields.io/travis/matiassingers/youtube-thumbnail.svg?style=flat-square)](https://travis-ci.org/matiassingers/youtube-thumbnail) [![Dependency Status](http://img.shields.io/gemnasium/matiassingers/youtube-thumbnail.svg?style=flat-square)](https://gemnasium.com/matiassingers/youtube-thumbnail)
> get thumbnail images for youtube videos

## Install

```sh
$ npm install --save youtube-thumbnail
```


## Usage

```js
var youtubeThumbnail = require('youtube-thumbnail');

var thumbnail = youtubeThumbnail('https://www.youtube.com/watch?v=9bZkp7q19f0');

console.log(thumbnail);
// => { default: { url: 'https://img.youtube.com/vi/9bZkp7q19f0/default.jpg', ...
```


## CLI

```sh
$ npm install --global youtube-thumbnail
```

```sh
$ youtube-thumbnail --help

  Example
    youtube-thumbnail https://www.youtube.com/watch?v=9bZkp7q19f0
       =>  https://img.youtube.com/vi/9bZkp7q19f0/default.jpg

    youtube-thumbnail https://www.youtube.com/watch?v=9bZkp7q19f0 --high --open
       =>  https://img.youtube.com/vi/9bZkp7q19f0/hqdefault.jpg

  Options
    --open
          opens the thumbnail image in your browser

    --medium
          returns the medium resolution thumbnail

    --high
          returns the high resolution thumbnail
```


## License

MIT © [Matias Singers](http://mts.io)

---
_Source: https://npm.io/package/youtube-thumbnail · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._