Supported Sites List
yt-dlp supports over 1000+ video websites. This chapter introduces some commonly used supported sites and their usage precautions.
Major Video Sites
YouTube
YouTube is one of the most well-supported sites in yt-dlp.
Supported Features
- ✅ Video downloading (all resolutions)
- ✅ Playlist downloading
- ✅ Channel downloading
- ✅ Live stream downloading
- ✅ Subtitle downloading (including auto-generated)
- ✅ Thumbnail downloading
- ✅ Comment section downloading
- ✅ Member-only videos (requires login)
Usage Examples
# Download a single video
yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"
# Download in best quality
yt-dlp -f "bestvideo+bestaudio/best" "https://www.youtube.com/watch?v=VIDEO_ID"
# Download a playlist
yt-dlp "https://www.youtube.com/playlist?list=PLAYLIST_ID"
# Download all videos from a channel
yt-dlp "https://www.youtube.com/@ChannelName/videos"
# Download a live stream
yt-dlp --live-from-start "https://www.youtube.com/watch?v=LIVE_ID"
# Download subtitles
yt-dlp --write-subs --sub-langs "en,zh-Hans" "https://www.youtube.com/watch?v=VIDEO_ID"
Bilibili
One of the most popular video sites in China.
Supported Features
- ✅ Video downloading
- ✅ Anime/Show downloading
- ✅ Playlist downloading
- ✅ Uploader video downloading
- ✅ Subtitle downloading
- ✅ Danmaku (bullet chat) downloading (partial support)
Usage Examples
# Download a regular video
yt-dlp "https://www.bilibili.com/video/BV_ID"
# Download an anime/show
yt-dlp "https://www.bilibili.com/bangumi/play/EP_ID"
# Download all videos from an uploader
yt-dlp "https://space.bilibili.com/USER_ID"
# Download a favorite list
yt-dlp "https://space.bilibili.com/USER_ID/favlist?fid=FAV_ID"
# Specify quality
yt-dlp -f "bestvideo[height<=1080]+bestaudio" "https://www.bilibili.com/video/BV_ID"
Twitter/X
Supported Features
- ✅ Video downloading
- ✅ GIF downloading
- ✅ Image downloading
- ✅ Tweet thread downloading
Usage Examples
# Download Twitter video
yt-dlp "https://twitter.com/user/status/TWEET_ID"
# Download X video
yt-dlp "https://x.com/user/status/TWEET_ID"
# Download all media in a tweet
yt-dlp "https://twitter.com/user/status/TWEET_ID"
Supported Features
- ✅ Video downloading
- ✅ Image downloading
- ✅ Reels downloading
- ✅ Stories downloading (requires login)
- ✅ IGTV downloading
Usage Examples
# Download Instagram video
yt-dlp "https://www.instagram.com/p/POST_ID"
# Download Reels
yt-dlp "https://www.instagram.com/reel/REEL_ID"
# Download Stories (requires login)
yt-dlp -u "username" -p "password" "https://www.instagram.com/stories/username"
# Download IGTV
yt-dlp "https://www.instagram.com/tv/TV_ID"
TikTok
Supported Features
- ✅ Video downloading
- ✅ No-watermark downloading
- ✅ Image downloading
- ✅ Playlist downloading
Usage Examples
# Download TikTok video
yt-dlp "https://www.tiktok.com/@user/video/VIDEO_ID"
# Download no-watermark video
yt-dlp "https://www.tiktok.com/@user/video/VIDEO_ID"
# Download TikTok playlist
yt-dlp "https://www.tiktok.com/@user"
Other Popular Sites
Vimeo
Professional video platform.
# Download Vimeo video
yt-dlp "https://vimeo.com/VIDEO_ID"
# Download password-protected video
yt-dlp --video-password "password" "https://vimeo.com/VIDEO_ID"
# Download Facebook video
yt-dlp "https://www.facebook.com/watch?v=VIDEO_ID"
# Download Reels
yt-dlp "https://www.facebook.com/reel/REEL_ID"
Twitch
Gaming live stream platform.
# Download Twitch video
yt-dlp "https://www.twitch.tv/videos/VIDEO_ID"
# Download live stream
yt-dlp "https://www.twitch.tv/CHANNEL_NAME"
# Download clips
yt-dlp "https://www.twitch.tv/clip/CLIP_ID"
Dailymotion
yt-dlp "https://www.dailymotion.com/video/VIDEO_ID"
# Download Reddit video
yt-dlp "https://www.reddit.com/r/subreddit/comments/POST_ID"
Pornhub
# Download video
yt-dlp "https://www.pornhub.com/view_video.php?viewkey=VIDEO_ID"
# Download video requiring login
yt-dlp --cookies-from-browser chrome "https://www.pornhub.com/view_video.php?viewkey=VIDEO_ID"
Chinese Video Sites
Youku
yt-dlp "https://v.youku.com/v_show/id_VIDEO_ID.html"
Tencent Video
yt-dlp "https://v.qq.com/x/page/VIDEO_ID.html"
iQIYI
yt-dlp "https://www.iqiyi.com/v_VIDEO_ID.html"
MGTV (Mango TV)
yt-dlp "https://www.mgtv.com/b/VIDEO_ID.html"
Sohu Video
yt-dlp "https://tv.sohu.com/v/VIDEO_ID.html"
Music Sites
SoundCloud
# Download audio
yt-dlp "https://soundcloud.com/user/track"
# Download playlist
yt-dlp "https://soundcloud.com/user/sets/playlist"
Mixcloud
yt-dlp "https://www.mixcloud.com/user/show/"
Bandcamp
yt-dlp "https://artist.bandcamp.com/track/song"
NetEase Cloud Music
yt-dlp "https://music.163.com/song?id=SONG_ID"
QQ Music
yt-dlp "https://y.qq.com/n/ryqq/songDetail/SONG_ID"
Social Media Sites
yt-dlp "https://www.pinterest.com/pin/PIN_ID"
Tumblr
yt-dlp "https://user.tumblr.com/post/POST_ID"
Snapchat
yt-dlp "https://www.snapchat.com/spotlight/SPOTLIGHT_ID"
News Media Sites
CNN
yt-dlp "https://www.cnn.com/videos/VIDEO_PATH"
BBC
yt-dlp "https://www.bbc.com/news/av/VIDEO_ID"
NBC
yt-dlp "https://www.nbcnews.com/video/VIDEO_ID"
Educational Sites
Coursera
# Requires login
yt-dlp -u "username" -p "password" "https://www.coursera.org/learn/course"
Udemy
# Requires login
yt-dlp -u "username" -p "password" "https://www.udemy.com/course"
edX
yt-dlp "https://www.edx.org/course/course-name"
Khan Academy
yt-dlp "https://www.khanacademy.org/video/video-name"
Other Sites
TED
yt-dlp "https://www.ted.com/talks/talk_name"
Streamable
yt-dlp "https://streamable.com/VIDEO_ID"
Imgur
yt-dlp "https://imgur.com/gallery/IMAGE_ID"
Gfycat
yt-dlp "https://gfycat.com/gfy-name"
View Full Support List
To see the complete list of all sites supported by yt-dlp, you can use the following commands:
# List all supported sites
yt-dlp --list-extractors
# List supported extractor descriptions
yt-dlp --extractor-descriptions
Or visit:
Precautions
1. Site Changes
Websites may update their page structure or API, which can cause yt-dlp to stop working properly. When encountering issues:
- Update yt-dlp to the latest version.
- Check GitHub Issues for similar problems.
- Try using the
--verboseparameter to see detailed error messages.
2. Geo-restrictions
Some videos may have geo-restrictions. These can be resolved by:
# Use a proxy
yt-dlp --proxy "socks5://127.0.0.1:1080" "URL"
# Use geo-bypass
yt-dlp --geo-bypass "URL"
# Specify a country
yt-dlp --geo-bypass-country US "URL"
3. Login Requirements
Certain content requires login to access:
# Use username and password
yt-dlp -u "username" -p "password" "URL"
# Use browser cookies
yt-dlp --cookies-from-browser chrome "URL"
# Use cookie file
yt-dlp --cookies cookies.txt "URL"
4. Download Limits
Some sites may have download restrictions:
# Lower download speed
yt-dlp --limit-rate 1M "URL"
# Increase retries
yt-dlp --retries 10 "URL"
# Use sleep interval
yt-dlp --sleep-interval 5 "URL"
5. Copyright Issues
Please comply with copyright laws and the website's terms of use:
- Only download content you have the right to download.
- Do not use for commercial purposes (unless authorized).
- Respect the rights of content creators.
Contributing New Site Support
If you find a site that is not supported, you can:
- Submit a request on GitHub Issues.
- Provide the website URL and detailed information.
- You can even develop an extractor yourself and submit a Pull Request.
Next Steps
- Check Technical Practice for real-world application cases.
- Check Parameters Detailed for how to optimize downloads.
