Package name in this build: yt-dlp 2026.10.26. These pages are the YouTube extractor and the shared downloader errors people hit from a server. yt-dlp supports many other sites. Those extractors are not covered here.
| Exception or message | What it means |
|---|---|
ExtractorError | All player responses are invalid. Your IP is likely being blocked by Youtube |
ExtractorError | The playability reason contains sign in, or password and OAuth login were used. |
ExtractorError | The reason contains This content isn't available, try again later. |
ExtractorError | YouTube returned a playerCaptchaViewModel. |
| Age-restricted screen text | The player response matches the age-gate checks. |
GeoRestrictedError | The video is not available from your location. |
| PO token warning | A client format needs a GVS PO token and none was provided. |
Requested format is not available | No selected format was available. The error text says to use --list-formats. |
SocialScrape#
Video details are GET /v1/youtube/video. Transcripts are GET /v1/youtube/video/transcript: the video's own captions. A video with no captions returns transcript_unavailable and costs nothing. AI transcription of YouTube audio is not available yet.
Failed requests cost 0 credits. New accounts get 100 credits on signup, no card.