> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supadata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported YouTube URL Formats and Examples | Supadata Docs

> Complete reference of all supported YouTube URL formats — video links, short URLs, Shorts, embeds, playlists, channels, and custom handles.

## Supported YouTube URL and Link Formats

When working with the Supadata API, you can reference any YouTube content using a variety of URL formats and link types. Whether you need to process a standard `youtube.com/watch` URL, a short `youtu.be` link, a YouTube Shorts link, or a channel handle — the API automatically detects and normalizes the input. Below is the complete reference of all supported YouTube link formats.

| Content Type | Supported Formats | Example |
| - | - | - |
| Videos | YouTube video URL | `https://youtube.com/watch?v=dQw4w9WgXcQ` |
| | Short URL | `http://youtu.be/dQw4w9WgXcQ` |
| | Shorts URL | `https://youtube.com/shorts/dQw4w9WgXcQ` |
| | Embed URL | `http://www.youtube.com/embed/dQw4w9WgXcQ` |
| | Live URL | `https://www.youtube.com/live/dQw4w9WgXcQ` |
| | Legacy URL | `https://www.youtube.com/v/dQw4w9WgXcQ`, `https://www.youtube.com/e/dQw4w9WgXcQ` |
| | Video ID | `dQw4w9WgXcQ` |
| Playlists | Playlist URL | `https://youtube.com/playlist?list=PL9tY0BWXOZFuFEG_GtOBZ8-8wbkH-NVAr` |
| | Playlist ID | `PL9tY0BWXOZFuFEG_GtOBZ8-8wbkH-NVAr` |
| Channels | Channel URL | `https://youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw` |
| | Custom URL | `https://youtube.com/c/RickAstley` |
| | Handle URL | `https://youtube.com/@RickAstley` |
| | Handle | `@RickAstley` or `RickAstley` |
| | Channel ID | `UCuAXFkgsw1L7xaCfnd5JJOw` |

### Not supported content types:

* Live stream videos - not possible to fetch transcripts of currently streamed videos
* Private videos - will return a `403 forbidden` error
* User profile links


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.