Accepted URLs, IDs, handles, and queries for every TranscriptFetch endpoint.
Each platform card shows the input forms the API recognizes and which listing endpoints are available.
Videos, channels, playlists, and search
watch, youtu.be, Shorts, embed, and /v/ URLs; /live/ URLs after the broadcast ends; bare 11-character video IDs; @handles; UC… channel IDs; and playlist URLs or IDs.
See supported URLsVideos, profiles, playlists, and search
Post URLs, vm.tiktok.com and vt.tiktok.com share links, bare 17–20 digit video IDs, profile URLs, and playlist URLs.
See supported URLsVideos, profiles, and search
Reel, post, and legacy /tv/ video URLs, plus profile URLs. Instagram does not expose playlist enumeration.
See supported URLsPublic audio and video files
A publicly reachable HTTP or HTTPS media URL, including MP4, MP3, WAV, and similar formats.
See supported URLsUse the endpoint for the resource you want back. Each route accepts the complete URL or identifier shown below.
Fetch one transcript from any supported video source or direct media file.
Open endpoint referencevideohttps://www.youtube.com/watch?v=dQw4w9WgXcQList videos from a YouTube channel, TikTok profile, or Instagram profile.
Open endpoint referencechannelhttps://www.youtube.com/@veritasiumplaylisthttps://www.youtube.com/playlist?list=PL…queryhow transformers workYou do not need to extract IDs yourself. Full URLs are parsed server-side. A YouTube watch URL containing list= can be sent to /api/v2/transcripts/video for that single video or /api/v2/transcripts/playlist for the full playlist.
The supported transcript sources are YouTube, TikTok, Instagram, and Direct media file.
Other public HTTP or HTTPS video pages are attempted with the generic extractor. This is best-effort compatibility, not a guarantee that every website or embedded player will work.
When a supported source has no captions, the AI transcription fallback covers YouTube, TikTok, Instagram, and direct media file URLs. Generic video pages remain best-effort extraction targets; AI transcription is not guaranteed for them.