# How to Get the Transcript of an Age-Restricted YouTube Video

Source: https://transcript-yt.com/blog/age-restricted-youtube-video-transcript · Updated 2026-11-18 · TranscriptYT

> Why transcript tools and APIs fail on age-restricted YouTube videos, what error you get, and the methods that still work: signed-in transcript panel and yt-dlp.

To get the transcript of an age-restricted YouTube video, sign in to a YouTube account that is verified as 18 or older and open the video's own transcript panel, or run a local tool such as yt-dlp with that account's cookies. Online transcript tools and transcript APIs, including ours, fetch videos without a signed-in adult account, so YouTube refuses them and they return an error instead of text. This guide explains exactly why that happens, what the failure looks like in the common libraries and in the [TranscriptYT API](https://transcript-yt.com/api), how to check a video before you spend time on it, and the methods that do work.

## Why age-restricted videos fail in transcript tools

YouTube's help page on [age-restricted content](https://support.google.com/youtube/answer/2802167) is direct about the rule: these videos are not viewable by users who are signed out or under 18. Embedded players on other sites redirect to YouTube, where the viewer must be signed in and over 18. Captions are delivered through the same player response as the video, so the rule covers transcripts too.

A transcript tool works by asking YouTube's player for a video's caption track list and then downloading one of those tracks. When the request comes from a server with no signed-in account, YouTube answers an age-restricted video with a playability error whose reason reads "Sign in to confirm your age" and sends no caption tracks at all. There is nothing to download, so the tool has nothing to show.

Older libraries used to get past the gate by presenting themselves as an embedded player or a TV client that YouTube did not check. YouTube has closed those routes one by one, and issue trackers for tools like yt-dlp record each time an age-gate workaround stopped working. That is why a script that handled restricted videos a few years ago now fails on the same links.

Since mid-2025 YouTube has also been estimating users' ages from account activity in the United States and other countries, and an account it judges to be under 18 is treated as a minor until the owner verifies their age with an ID, a selfie, or a credit card. So even a signed-in account may not see restricted videos if YouTube has not confirmed it as adult.

## What the error looks like in common libraries and tools

Each tool reports the same underlying refusal in its own words. Knowing the message saves you from debugging proxies or upgrading packages when the video itself is the blocker.

- youtube-transcript-api (Python): version 1.0 and later raise an AgeRestricted exception, which the project describes as a video that requires cookie authentication. Check the project's README for the current state of cookie support before relying on it.
- yt-dlp: fails with "Sign in to confirm your age. This video may be inappropriate for some users." unless you pass cookies from a signed-in adult account.
- Browser-based transcript sites: usually a generic "no transcript found" or "video unavailable" message, because they get the same empty answer from YouTube.
- TranscriptYT API: HTTP 404 with code VIDEO_UNAVAILABLE and the message "This video is age-restricted, so its transcript can't be fetched."
- TranscriptYT free tool at [/youtube-transcript](https://transcript-yt.com/youtube-transcript): the message "This video is private, deleted, or unavailable."

## What happens when you request one from the TranscriptYT API

TranscriptYT fetches public videos without a YouTube account, so it cannot read age-restricted videos and does not try to work around the gate. What it does is fail fast and clearly, so your code can tell an age gate apart from a temporary problem. The check runs on the player response before any caption or AI step, which means mode=ai does not help: the audio is behind the same gate as the captions.

Failed requests are never billed, so an age-restricted video costs you nothing, and the response is a 404 rather than a 503, so a retry loop should not repeat it. Here is the request and the error body, using the same endpoint and key header as the [API docs](https://transcript-yt.com/docs):

```
curl "https://transcript-yt.com/v1/transcript?url=VIDEO_ID" \
  -H "Authorization: Bearer ts_live_xxxx"

HTTP/1.1 404
{
  "error": {
    "code": "VIDEO_UNAVAILABLE",
    "message": "This video is age-restricted, so its transcript can't be fetched."
  }
}

# Python: skip age-gated videos in a batch instead of retrying them
import requests

res = requests.get(
    "https://transcript-yt.com/v1/transcript",
    params={"url": video_id},
    headers={"Authorization": "Bearer ts_live_xxxx"},
)
if res.status_code == 404:
    err = res.json()["error"]
    if "age-restricted" in err["message"]:
        skipped.append(video_id)  # needs a signed-in adult account
    else:
        missing.append((video_id, err["code"]))
elif res.ok:
    transcripts[video_id] = res.json()
```

## How to check if a YouTube video is age-restricted

Before you spend time on a failing link, confirm what you are dealing with. A video that plays in a private browser window while signed out is not age-restricted, and its transcript problem lies elsewhere, such as missing captions or a blocked IP.

If you want to check without opening YouTube, paste the link into the [YouTube video stats tool](https://transcript-yt.com/youtube-video-stats). It reads the video's public details, and its "Made for everyone" row shows "Age-restricted" when YouTube marks the video as not family safe, or "Unknown" if YouTube does not report it.

- Signed out, YouTube shows "Sign in to confirm your age" over the player instead of playing the video.
- On a site that embeds the video, clicking play sends you to YouTube instead of playing in place.
- If you upload the video yourself, YouTube Studio shows "Viewable by 18+" under Notices on the Content page, and the Age-Restriction filter lists every affected video.

## Get the transcript on YouTube while signed in

For one or a few videos, the fastest method is YouTube's own transcript panel. It is the same caption data a tool would fetch, shown to you because your account passes the age check.

The panel has no download button, so copying it means selecting the text by hand. If the button is missing entirely, see [why the Show transcript button is not showing](https://transcript-yt.com/blog/youtube-show-transcript-button-not-showing); on a phone, the steps are in [how to see a transcript in the YouTube app](https://transcript-yt.com/blog/how-to-see-transcript-on-youtube-app).

- Sign in to a YouTube account that YouTube treats as 18 or older. If it has flagged the account as a minor, use the age verification it offers first.
- Open the video on youtube.com in a desktop browser, not in an embedded player.
- Expand the description and click "Show transcript" near the bottom.
- Use the three-dot menu in the transcript panel to turn timestamps off if you only want the text.
- Select the lines, copy them, and paste them into a document.

## Download age-restricted subtitles with yt-dlp and your own cookies

For a batch of restricted videos, or when you want a subtitle file, run yt-dlp on your own computer with the cookies from the browser where you are signed in. yt-dlp then makes the requests as your account, so the age check passes, and it can save the caption track without downloading the video.

Use this only with your own account, on your own machine, and at a modest pace. Cookies are as sensitive as your password, they expire, and heavy automated use from one account can get it flagged. If yt-dlp reports a bot check rather than an age check, that is a different problem covered in [fixing yt-dlp's "Sign in to confirm you're not a bot"](https://transcript-yt.com/blog/yt-dlp-sign-in-to-confirm-not-a-bot).

- Install or update yt-dlp, since YouTube changes often break older versions.
- Run: yt-dlp --cookies-from-browser firefox --skip-download --write-subs --write-auto-subs --sub-langs en --sub-format vtt "VIDEO_URL"
- Replace firefox with chrome, edge, or safari to match the browser you are signed in with, and en with the language you need.
- --write-subs saves uploaded captions and --write-auto-subs saves YouTube's automatic ones; keep both so you get whichever exists.
- Open the .vtt file in a text editor, or strip the timing lines if you only want the words.

## If the age-restricted video is your own

Creators have a cleaner route. In YouTube Studio, open the video, go to Subtitles, and download the caption track you uploaded or the automatic one. No third-party tool is involved, and the restriction does not apply to you as the owner.

For automation across your own channel, the YouTube Data API's captions.download method works with an OAuth sign-in from the channel owner. It does not work for other people's videos, which is the usual cause of the error described in [captions.download returning 403 Forbidden](https://transcript-yt.com/blog/youtube-data-api-captions-download-403-forbidden).

If the restriction was applied by mistake, Studio lets you appeal it. Once YouTube lifts it, every transcript tool, including TranscriptYT's free tool and API, works on the video again.

## When a transcript tool is still the right choice

Age-restricted videos are a small share of YouTube. For the rest, which includes most lectures, podcasts, interviews, and tutorials, a server-side tool is faster than any manual method. The free [YouTube transcript tool](https://transcript-yt.com/youtube-transcript) returns text, SRT, or VTT from a link, and the API returns JSON, text, SRT, VTT, CSV, or Markdown for 1 credit per transcript, with 100 free credits on the Free plan and paid plans from $3 a month for 1,000 credits. Paid plans also transcribe the audio of videos that have no captions.

A practical setup for a mixed list of links: send everything through the API, collect the age-restricted failures from their 404 message, and handle that short list by hand on YouTube or with yt-dlp on your own machine.

## FAQ

### Can you get a transcript of an age-restricted YouTube video?

Yes, but only through a signed-in YouTube account that is verified as 18 or older: use the Show transcript panel on youtube.com, or yt-dlp with that account's cookies. Online tools and transcript APIs that fetch without an account get no captions for these videos.

### Why does youtube-transcript-api raise AgeRestricted?

YouTube refused to return the video's captions because the request was not from a signed-in adult account. Upgrading the package or changing proxies will not fix it; the video needs an authenticated request.

### Does TranscriptYT work with age-restricted videos?

No. The API returns a 404 VIDEO_UNAVAILABLE error saying the video is age-restricted, and failed requests are not billed. AI transcription does not help either, because the audio is behind the same age check.

### Can I transcribe an age-restricted video without signing in?

No reliable method exists. YouTube does not serve these videos or their captions to signed-out viewers, and the old embed-player workarounds have been closed.
