yt-dlp Command Generator for Pinterest

Build a yt-dlp command for Pinterest video pins.

Video, playlist or channel URL

Optional. Leave it empty and the command ends with URL for you to fill in.

Your command

yt-dlp --merge-output-format mp4 --no-playlist https://www.pinterest.com/pin/123456789/

Basics

What do you want

Video Audio only

Audio-only extracts the soundtrack and drops the video stream.

Video and quality

Maximum quality -f

Caps the height. yt-dlp still picks the best stream at or below it.

Container --merge-output-format needs ffmpeg

The file type separate video and audio streams are merged into.

Advanced options (3)

Custom format selector -f

Overrides the quality dropdown. For people who already know the format syntax.

Remux into --remux-video needs ffmpeg

Repackages the streams without re-encoding. Fast and lossless.

Re-encode into --recode-video needs ffmpeg

Re-encodes the video. Slow and lossy — only when remuxing will not do.

Audio

Audio format --audio-format needs ffmpeg

The file the audio is converted to.

Audio quality --audio-quality needs ffmpeg

VBR gives the best size-to-quality ratio; fixed bitrates are more predictable.

Subtitles

Embedding puts them inside the video; saving writes a separate .srt next to it.

Subtitle languages --sub-langs

Comma separated. Use all for every available language.

Auto-generated subtitles --write-auto-subs Include machine-generated captions when no human ones exist.

Playlists and channels

Playlist handling

What to do when the URL belongs to both a video and a playlist.

Which items -I

Ranges and lists both work, for example 1-10,15 or -5::2 for every second item from the end.

Advanced options (1)

Archive file --download-archive

Records what has been downloaded so re-running skips it. The way to keep a channel in sync.

Sections and chapters

Advanced options (2)

Download only part of it --download-sections needs ffmpeg

A time range like *00:01:30-00:03:00, or a chapter name. The leading asterisk means it is a timestamp.

Split into chapters --split-chapters needs ffmpeg Writes one file per chapter instead of a single long one.

Metadata and artwork

Embed thumbnail --embed-thumbnail needs ffmpeg Uses the video thumbnail as cover art.

Embed metadata --embed-metadata needs ffmpeg Writes title, uploader and date into the file itself.

Embed chapters --embed-chapters needs ffmpeg Adds chapter markers your player can jump between.

Advanced options (3)

Save thumbnail file --write-thumbnail Writes the cover image next to the video.

Save description --write-description Writes the description to a .description file.

Save metadata JSON --write-info-json Writes everything yt-dlp knows about the video to a .info.json file.

SponsorBlock

Remove segments --sponsorblock-remove needs ffmpeg

Cuts community-marked segments out of the file using SponsorBlock data.

Advanced options (1)

Mark segments as chapters --sponsorblock-mark

Keeps the segments but marks them, so you can skip them yourself.

Files and folders

File name template -o

Field names go in %(...)s. Slashes create folders.

Safe (ASCII) file names --restrict-filenames Strips accents, spaces and anything a stubborn filesystem might reject.

Overwrite existing files --force-overwrites Replaces files that are already there.

Resume partial downloads -c Picks up where an interrupted download stopped.

Advanced options (4)

Download folder -P

Where files are written. Combine with the template above for subfolders.

Windows-safe names --windows-filenames Removes characters Windows refuses even when running elsewhere.

Trim names to --trim-filenames

Maximum file name length in characters.

Never overwrite -w Skips anything already downloaded.

Filters

Advanced options (5)

Uploaded after --dateafter

YYYYMMDD, or a relative date like now-1month.

Uploaded before --datebefore

YYYYMMDD, or a relative date.

Minimum size --min-filesize

Skips anything smaller. Accepts 5M, 500K and similar.

Maximum size --max-filesize

Skips anything larger.

Stop after --max-downloads

Number of files to download before stopping.

Network

Speed limit -r

For example 2M or 500K. Useful when you need the rest of your bandwidth.

Advanced options (5)

Parallel fragments -N

Speeds up fragmented streams. Four is a sensible starting point.

Retries -R

How many times to retry a failed piece. infinite is allowed.

Proxy --proxy

HTTP, HTTPS or SOCKS proxy URL.

Bypass geo-restriction --geo-bypass Fakes the request origin. Works on some sites, not all.

Impersonate a browser --impersonate

Makes requests look like a real browser. The usual fix for sudden 403 errors.

Cookies from browser --cookies-from-browser

Reads your logged-in session directly. Needed for private, age-restricted or members-only content.

Advanced options (1)

Cookies file --cookies

A Netscape-format cookies.txt exported from your browser.

Live streams

Advanced options (2)

Record from the start --live-from-start Starts a live stream from the beginning instead of the current moment.

Wait for the stream --wait-for-video

Polls until a scheduled stream begins. MIN-MAX seconds between checks.

Workarounds

Advanced options (3)

User agent --user-agent deprecated

Deprecated in favour of --add-headers. Kept because plenty of older guides still use it.

Referer --referer deprecated

Deprecated in favour of --add-headers.

Extractor arguments --extractor-args

Site-specific switches, for example youtube:player_client=web.

Output and debugging

List formats only -F Prints the available formats and exits without downloading.

Advanced options (2)

Keep going on errors -i Skips items that fail instead of stopping. Essential for large playlists.

Simulate -s Does everything except write the file.

Reset

The options that matter here

Maximum quality -f Caps the height. yt-dlp still picks the best stream at or below it.
File name template -o Field names go in %(...)s. Slashes create folders.

Notes for Pinterest

Individual pin URLs containing video work directly and need no special options.

Whole-board support is limited and changes with Pinterest's own markup. Passing pin URLs one at a time is slower and considerably more reliable.

Not every pin is a video — most are images — and a board handed to yt-dlp whole comes back mostly as image entries. The video pins are what this page is for: open the pin, copy the address of the pin page itself (not the i.pinimg.com image URL the browser shows), and let yt-dlp resolve whether media behind it is a video. When yt-dlp answers with an image, that pin genuinely has none; there is no option that turns an image pin into a video one.

Pinterest gates some content behind a login, and unlike most platforms the gate applies to browsing as much as to downloading — without cookies, boards stop after the first page and video pins in some categories return nothing at all. The browser-cookies option is the reliable route here: log in as usual in your browser, hand the cookie jar to yt-dlp, and pagination follows the account you are signed in with. Cookies from a logged-out session buy nothing.

For a long board or a profile worth keeping in step with, combine cookies with the archive file and run the same command on a schedule: the archive records every pin already fetched, so each later run transfers only what was pinned since the last one. Expect the shape of the output to change over time — Pinterest redesigns its markup more often than any other platform yt-dlp supports, and when a board suddenly downloads as one giant gallery or loses its titles, an updated yt-dlp is usually the whole fix. Report it only if updating does not clear it.

Name the output for the board, not the pin. Pin titles repeat — "Untitled", the board name, or nothing at all — so a plain title template collides within a single run; the default template here keeps the id, which is unique, and adding the playlist index keeps a board download in board order. Sections inside a board arrive as sub-playlists, and the archive file tracks every level of that without re-downloading anything on the next run.

Frequently asked questions

› Can yt-dlp download Pinterest videos?

Yes, pin URLs containing video work directly.

› Can I download a whole board?

Board support is limited and changes often. Passing individual pin URLs is more reliable.