yt-dlp: [vimeo] An extractor error has occurred. (caused by KeyError('config_url'))

Checklist

  • I’m reporting that yt-dlp is broken on a supported site
  • I’ve verified that I have updated yt-dlp to nightly or master (update instructions)
  • I’ve checked that all provided URLs are playable in a browser with the same IP and same login details
  • I’ve checked that all URLs and arguments with special characters are properly quoted or escaped
  • I’ve searched known issues, the FAQ, and the bugtracker for similar issues including closed ones. DO NOT post duplicates
  • I’ve read about sharing account credentials and I’m willing to share it if required

Region

china

Provide a description that is worded well enough to be understood

[vimeo] Extracting URL: https://vimeo.com/812978620 [vimeo] 812978620: Downloading webpage [vimeo] 812978620: Downloading viewer info [vimeo] 812978620: Downloading API JSON ERROR: 812978620: An extractor error has occurred. (caused by KeyError(‘config_url’)); please report this issue on https://github.com/yt-dlp/yt-dlp/issues?q= , filling out the appropriate issue template. Confirm you are on the latest version using yt-dlp -U File “C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Lib\site-packages\yt_dlp\extractor\common.py”, line 746, in extract ie_result = self._real_extract(url) ^^^^^^^^^^^^^^^^^^^^^^^ File “C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Lib\site-packages\yt_dlp\extractor\vimeo.py”, line 1025, in _real_extract return self._extract_from_api(video_id) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File “C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Lib\site-packages\yt_dlp\extractor\vimeo.py”, line 882, in _extract_from_api video[‘config_url’], video_id), video_id) ~~~~~^^^^^^^^^^^^^^ KeyError: ‘config_url’

Provide verbose output that clearly demonstrates the problem

  • Run your yt-dlp command with -vU flag added (yt-dlp -vU <your command line>)
  • If using API, add 'verbose': True to YoutubeDL params instead
  • Copy the WHOLE output (starting with [debug] Command-line config) and insert it below

Complete Verbose Output

[debug] Encodings: locale cp936, fs utf-8, pref cp936, out utf-8, error utf-8, screen utf-8
[debug] yt-dlp version stable@2025.02.19 from yt-dlp/yt-dlp [4985a4041] (pip) API
[debug] params: {'format': 'bestvideo[height<=1440]+bestaudio/best', 'merge_output_format': 'mp4', 'max_filesize': 629145600, 'postprocessors': [], 'writedescription': False, 'writeinfo_json': False, 'writethumbnail': False, 'quiet': False, 'noprogress': False, 'verbose': True, 'concurrent_fragment': 8, 'retries': 3, 'socket_timeout': 60, 'filetimeout': 300, 'match_filter': <function CleanDownloader.download.<locals>.match_filter at 0x000001E9E04B5080>, 'outtmpl': 'J:\\winjoy_design_material\\0视频合集\\0牛逼工作室\\Hornet/%(upload_date)s %(title)s - %(uploader_id)s .%(ext)s', 'download_archive': 'J:\\winjoy_design_material\\0视频合集\\0牛逼工作室\\Hornet/archive.txt', 'write_sub': True, 'write_auto_subs': True, 'sub_lang': 'en,zh-Hans', 'convert_subtitles': 'srt', 'cookiefile': 'C:\\Users\\Administrator\\Downloads\\cookie.txt', 'compat_opts': set(), 'http_headers': {'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.77 Safari/537.36', 'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8', 'Accept-Language': 'en-us,en;q=0.5', 'Sec-Fetch-Mode': 'navigate'}}
[debug] Python 3.12.7 (CPython AMD64 64bit) - Windows-11-10.0.26100-SP0 (OpenSSL 3.0.15 3 Sep 2024)
[debug] exe versions: ffmpeg 7.0.2-full_build-www.gyan.dev (setts), ffprobe 7.0.2-full_build-www.gyan.dev, phantomjs 2.1.1
[debug] Optional libraries: Cryptodome-3.20.0, brotli-1.1.0, certifi-2024.08.30, curl_cffi-0.5.10, mutagen-1.47.0, requests-2.32.3, secretstorage-3.3.3, sqlite3-3.45.3, urllib3-2.3.0, websockets-12.0
[debug] Proxy map: {'http': 'http://127.0.0.1:7890', 'https': 'http://127.0.0.1:7890', 'ftp': 'http://127.0.0.1:7890'}
[debug] Request Handlers: urllib, requests, curl_cffi
[debug] Extractor Plugins: SamplePluginIE, sample (YoutubeIE)
[debug] Post-Processor Plugins: SamplePluginPP
[debug] Plugin directories: ['C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\yt_dlp_plugins']
[debug] Loaded 1842 extractors
[debug] Loading archive file 'J:\\winjoy_design_material\\0视频合集\\0牛逼工作室\\Hornet/archive.txt'
[vimeo:user] Extracting URL: https://vimeo.com/hellohornet
[vimeo:user] hellohornet: Downloading page 1

About this issue

  • Original URL
  • State: closed
  • Created 2 years ago
  • Reactions: 5
  • Comments: 30 (11 by maintainers)

Commits related to this issue

Most upvoted comments

I can’t download from Vimeo either, same error. Is there any workaround that could make it work today? Thank you!

Mac OS Sonoma 14.7.2 - M1 Ultra Mac Studio

Steps to reproduce:

  1. download latest release of yt-dlp_macos from https://github.com/yt-dlp/yt-dlp#release-files
  2. % chmod a+rx ~/Downloads/yt-dlp_macos
  3. % sudo mv ~/Downloads/yt-dlp_macos /usr/local/bin/yt-dlp
  4. % yt-dlp
  5. Mac security warning: Show in Finder
  6. right click yt-dlp executable, click Open
  7. % yt-dlp https://vimeo.com/1075236679

[vimeo] Extracting URL: https://vimeo.com/1075236679 [vimeo] 1075236679: Downloading webpage [vimeo] 1075236679: Downloading viewer info [vimeo] 1075236679: Downloading API JSON ERROR: 1075236679: An extractor error has occurred. (caused by KeyError(‘config_url’)); please report this issue on https://github.com/yt-dlp/yt-dlp/issues?q= , filling out the appropriate issue template. Confirm you are on the latest version using yt-dlp -U

You can workaround for most of videos by switching to embed/player URL: https://player.vimeo.com/video/1075236679

@yucelyilmaz update to master, yt-dlp --update-to master

You can workaround for most of videos by switching to embed/player URL: https://player.vimeo.com/video/1075236679

Thank you very much for this workaround! It does work for me, for that example video I gave.

(I did get the audio and video as separate files, but that’s a different issue I think — “WARNING: You have requested merging of multiple formats but ffmpeg is not installed. The formats won’t be merged” — I guess I probably do need to install ffmpeg on this Mac.)

In my case the actual Vimeo video I was trying to download today is a password protected one. When I try using that player.vimeo.com URL and the --video-password parameter, the error I get is:

ERROR: [vimeo] 977202409: Cannot download embed-only video without embedding URL. Please call yt-dlp with the URL of the page that embeds this video.

I wonder if a workaround for that, would be to actually embed the passworded video in a public web page?

But ultimately I was able to download the passworded Vimeo video earlier with a Firefox extension I found, Video DownloadHelper. Thanks again for the reply, and I’m sure you’ll have Vimeo downloads fixed soon. Appreciate your help, it’s a great tool.

I am still seeing this issue as well:

The fix was only added a few hours ago, the Nightly build hasn’t been updated for the day yet. Wait for nightly@2025.04.29.

I have been successfully downloading from vimeo for years, but suddenly I also get this same error. Running stable@2025.03.31.

Just ran into this, it seems ([https://vimeo.com/817032671]). I tried “inspecting” and finding a target URL for the generic downloader, found a playlist.json that seemed somewhat promising but I did not succeed with it. Are there any known workarounds?

After examining the JS, I see that the anon_signature param is plucked from the content of the <meta> tag in the webpage with name="video-signature-{video_id}". There doesn’t seem to be any other way to generate it.

So now the web API is locked behind the webpage which is locked behind cloudflare turnstile

(base) ➜  Scraper.Service git:(release) ✗ yt-dlp https://vimeo.com/465523861 -vU
[debug] Command-line config: ['https://vimeo.com/465523861', '-vU']
[debug] Encodings: locale UTF-8, fs utf-8, pref UTF-8, out utf-8, error utf-8, screen utf-8
[debug] yt-dlp version master@2025.04.23.143136 from yt-dlp/yt-dlp-master-builds [2381881fe] (zip)
[debug] Python 3.11.5 (CPython arm64 64bit) - macOS-15.4.1-arm64-arm-64bit (OpenSSL 3.0.12 24 Oct 2023)
[debug] exe versions: ffmpeg 4.2.2, ffprobe 4.2.2
[debug] Optional libraries: Cryptodome-3.22.0, brotli-1.1.0, certifi-2025.01.31, mutagen-1.47.0, requests-2.32.3, sqlite3-3.41.2, urllib3-2.4.0, websockets-15.0.1, xattr-1.1.0
[debug] Proxy map: {}
[debug] Request Handlers: urllib, requests, websockets
[debug] Plugin directories: /Users/martymavis/miniconda3/lib/python3.11/site-packages/yt_dlp_plugins
[debug] Loaded 1856 extractors
[debug] Fetching release info: https://api.github.com/repos/yt-dlp/yt-dlp-master-builds/releases/latest
Latest version: master@2025.04.23.143136 from yt-dlp/yt-dlp-master-builds
yt-dlp is up to date (master@2025.04.23.143136 from yt-dlp/yt-dlp-master-builds)
[vimeo] Extracting URL: https://vimeo.com/465523861
[vimeo] 465523861: Downloading webpage
WARNING: [vimeo] The extractor is attempting impersonation, but no impersonate target is available; if you encounter errors, then see  https://github.com/yt-dlp/yt-dlp#impersonation  for information on installing the required dependencies
[vimeo] 465523861: Downloading viewer info
[vimeo] 465523861: Downloading API JSON
ERROR: 465523861: An extractor error has occurred. (caused by KeyError('config_url')); please report this issue on  https://github.com/yt-dlp/yt-dlp/issues?q= , filling out the appropriate issue template. Confirm you are on the latest version using  yt-dlp -U
  File "/usr/local/bin/yt-dlp/yt_dlp/extractor/common.py", line 748, in extract
    ie_result = self._real_extract(url)
                ^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/bin/yt-dlp/yt_dlp/extractor/vimeo.py", line 1036, in _real_extract
    return self._extract_from_api(video_id)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/bin/yt-dlp/yt_dlp/extractor/vimeo.py", line 893, in _extract_from_api
    video['config_url'], video_id), video_id)
    ~~~~~^^^^^^^^^^^^^^
KeyError: 'config_url'