[go: up one dir, main page]
GitHubLog in
Start here
Supported YouTube URL formats

Accepted YouTube video, channel, and playlist URLs and IDs for the TranscriptFetch API.

Send the complete YouTube link or identifier. TranscriptFetch normalizes it server-side, so your integration does not need to extract video, channel, or playlist IDs first.

Accepted formats

Videos

Input formatExample
Watch URLhttps://www.youtube.com/watch?v=dQw4w9WgXcQ
Short URLhttps://youtu.be/dQw4w9WgXcQ
Shorts URLhttps://www.youtube.com/shorts/dQw4w9WgXcQ
Embed URLhttps://www.youtube.com/embed/dQw4w9WgXcQ
Legacy /v/ URLhttps://www.youtube.com/v/dQw4w9WgXcQ
Completed live URLhttps://www.youtube.com/live/dQw4w9WgXcQ
Video IDdQw4w9WgXcQ

Channels

Input formatExample
Handle@veritasium
Handle URLhttps://www.youtube.com/@veritasium
Channel IDUCHnyfMqiRRG1u-2MsSQLbXA
Channel ID URLhttps://www.youtube.com/channel/UCHnyfMqiRRG1u-2MsSQLbXA
Custom channel URLhttps://www.youtube.com/c/veritasium
Legacy user URLhttps://www.youtube.com/user/veritasium

Playlists

Input formatExample
Playlist URLhttps://www.youtube.com/playlist?list=PL9tY0BWXOZFuFEG_GtOBZ8-8wbkH-NVAr
Playlist IDPL9tY0BWXOZFuFEG_GtOBZ8-8wbkH-NVAr

Search

Input formatExample
Keyword queryhow transformers work

Endpoints available for this source

POST/api/v2/transcripts/video

Fetch a transcript (YouTube, TikTok, Instagram, or file URL)

Accepted input: video

Open endpoint reference
POST/api/v2/transcripts/channel

List a channel's or profile's videos, Shorts, streams or playlists

Accepted input: channel

Open endpoint reference

Availability requirements

The source must be publicly accessible without signing in. Live URLs work after the broadcast has ended; active live streams, private or members-only videos, removed videos, and strongly restricted videos may not return a transcript.

Example request

Use the same input with REST or either official SDK.

curl -X POST https://transcriptfetch.com/api/v2/transcripts/video \
  -H "Authorization: Bearer $TRANSCRIPTFETCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'