Skip to main content

How to Resolve Python "ERROR: YouTube said: Unable to extract video data" of youtube-dl library

When using the command-line tool youtube-dl to download videos, you might encounter the error: ERROR: YouTube said: Unable to extract video data. This usually signifies that youtube-dl cannot parse the YouTube webpage or API response correctly to find the necessary video information. The most common reason is that YouTube has updated its website structure or API, and your version of youtube-dl is too old to understand the changes.

This guide explains why this error occurs and provides solutions, primarily focusing on upgrading youtube-dl or switching to the actively maintained fork, yt-dlp.

Understanding the Error: Parsing Failure​

Websites like YouTube frequently update their internal structure, video player code, and APIs. Tools like youtube-dl work by parsing these structures to find the actual video stream URLs and metadata. When YouTube changes something, older versions of youtube-dl might no longer know where to look, leading to the "Unable to extract video data" error. It essentially means the tool's parsing logic is broken for the current state of YouTube.

Primary Cause: Outdated youtube-dl Version​

Because YouTube updates frequently, youtube-dl (and its forks) need constant updates to keep working reliably. If you encounter this error, the most likely reason is that your installed version is outdated and doesn't contain the latest fixes required to parse YouTube pages correctly.

Solution 1: Upgrade youtube-dl (Choose ONE Method)​

Updating youtube-dl to the latest available version often resolves the issue. Choose the command relevant to how you originally installed it.

Using pip (Python Package Installer - Most Common)​

If you installed youtube-dl using Python's package installer, pip:

# Upgrade using pip (use pip3 if that's your Python 3 pip)
pip install --upgrade youtube-dl
# Or explicitly:
# pip3 install --upgrade youtube-dl

# If pip isn't in your PATH:
# python -m pip install --upgrade youtube-dl
# python3 -m pip install --upgrade youtube-dl

# If you get permission errors:
# pip install --upgrade youtube-dl --user # Install to user directory
# Or (use with caution, affects system Python):
# sudo pip3 install --upgrade youtube-dl # Linux/macOS

This command fetches and installs the latest version available on PyPI (the Python Package Index).

Using Homebrew (macOS)​

If you installed youtube-dl using Homebrew on macOS:

# Update Homebrew's package list first (good practice)
brew update

# Upgrade youtube-dl
brew upgrade youtube-dl

Using Chocolatey (Windows)​

If you installed youtube-dl using Chocolatey on Windows:

# Upgrade youtube-dl via Chocolatey
choco upgrade youtube-dl

Direct Download/Update (curl, wget, --update)​

If you installed youtube-dl manually (e.g., by downloading the executable directly, common on Linux/macOS):

  • Using curl or wget (Unix-like systems): This downloads the latest executable directly.

    # Using curl
    sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl -o /usr/local/bin/youtube-dl
    sudo chmod a+rx /usr/local/bin/youtube-dl

    # OR Using wget
    sudo wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl
    sudo chmod a+rx /usr/local/bin/youtube-dl
    note

    Adjust the path /usr/local/bin/ if you installed it elsewhere.

  • Using the built-in update flag: If you have an executable version, it might have a self-update mechanism (this often fails if the current version is too old or broken).

    youtube-dl --update

Solution 2: Reinstall youtube-dl​

If upgrading doesn't work (perhaps due to a corrupted installation), try completely removing and then reinstalling the package.

General Reinstall via pip​

# Uninstall (use pip/pip3/python -m pip as appropriate)
pip uninstall -y youtube-dl

# Reinstall (use --upgrade to ensure latest)
pip install --upgrade youtube-dl

Specific Reinstall for Ubuntu (apt)​

note

Versions in apt are often very outdated

If you installed youtube-dl using Ubuntu's apt package manager, you might need to remove that version first before installing via pip.

# 1. Remove the apt version (if installed)
sudo apt purge youtube-dl

# 2. Install the up-to-date version using pip3
sudo pip3 install --upgrade youtube-dl # Install system-wide via pip

# 3. Optional: Update shell's command cache
hash youtube-dl
note

It's generally recommended to use pip for youtube-dl/yt-dlp rather than system package managers like apt to get more frequent updates.

The original youtube-dl project has seen slower development recently. A fork called yt-dlp is much more actively maintained, incorporates fixes and new features faster, and generally works more reliably with YouTube and other sites. Switching to yt-dlp is the most recommended solution.

Why Use yt-dlp?​

  • Actively developed and frequently updated.
  • Often fixes YouTube extraction errors faster than youtube-dl.
  • Includes additional features and improvements.
  • Largely command-line compatible with youtube-dl.

Installing yt-dlp​

Use pip to install yt-dlp. It's good practice to uninstall youtube-dl first to avoid potential conflicts, though not always strictly necessary.

# Optional: Uninstall old youtube-dl
# pip uninstall -y youtube-dl

# Install or upgrade yt-dlp using pip
pip install --upgrade yt-dlp
# Or: pip3 install --upgrade yt-dlp
# Or: python -m pip install --upgrade yt-dlp
# etc...

Basic yt-dlp Usage Example​

The command-line usage is very similar to youtube-dl.

# Example: Download a YouTube video as MP4
# Replace URL with the video you want
yt-dlp "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -o "my_downloaded_video.mp4"

# Example: Download best audio format
yt-dlp -f bestaudio "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -o "my_audio.%(ext)s"

Refer to the yt-dlp documentation for extensive options.

Conclusion​

The youtube-dl error "ERROR: YouTube said: Unable to extract video data" almost always means your copy of the tool is outdated and can no longer parse YouTube's current website structure.

  1. Try upgrading youtube-dl using the method corresponding to your installation (pip, brew, choco, direct download).
  2. If upgrading fails, try reinstalling youtube-dl.
  3. Strongly consider switching to yt-dlp (pip install --upgrade yt-dlp). It is more actively maintained and generally provides a more reliable experience for downloading from YouTube and other sites.

Keeping your download tool up-to-date is essential due to the constantly changing nature of web platforms like YouTube. yt-dlp is currently the best option for this.

Table of Contents