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

# Supported sites

> Which URLs Importly can fetch: public videos and audio on YouTube, TikTok, X, Instagram, Vimeo, podcasts, and 1000+ other sites, plus direct media file links.

Send the URL of the page where the media plays, the same link you'd share. Importly works with YouTube, TikTok, X, Instagram, Vimeo, Facebook, Reddit, SoundCloud, Twitch, Dailymotion, and over 1,000 other sites, plus podcast episode pages and direct links to media files.

## URL examples

| Source | Example URL |
| - | - |
| YouTube video | `https://www.youtube.com/watch?v=jNQXAC9IVRw` |
| YouTube short link | `https://youtu.be/jNQXAC9IVRw` |
| YouTube Shorts | `https://www.youtube.com/shorts/<id>` |
| TikTok | `https://www.tiktok.com/@<user>/video/<id>` |
| X | `https://x.com/<user>/status/<id>` |
| Instagram reel or post | `https://www.instagram.com/reel/<id>/` |
| Vimeo | `https://vimeo.com/<id>` |
| A media file | `https://example.com/conference-talk.mp4` |

A YouTube watch URL that also carries a `&list=` parameter is treated as that single video.

## What can't be fetched

Each of these fails the job with a `code` you can handle in your app. Nothing is charged for a failed import, and failed transcriptions are refunded.

| Case | `code` |
| - | - |
| Private videos | `VIDEO_PRIVATE` |
| Media that needs a login, or is password-protected | `AUTH_REQUIRED` |
| Age-restricted videos | `AGE_RESTRICTED` |
| Deleted or unavailable videos | `VIDEO_UNAVAILABLE` |
| Videos blocked in every region we can fetch from | `GEO_BLOCKED` |
| Playlist pages, such as `youtube.com/playlist?list=…` | `PLAYLIST_NOT_SUPPORTED` |
| Live streams that haven't ended | `LIVE_NOT_SUPPORTED` |
| URLs that aren't valid, or aren't media | `INVALID_URL` |

> [!NOTE]
>
> If a source temporarily refuses a request, the job fails with `SOURCE_THROTTLED`. Retrying a little later usually works.

## Check a URL before you pay for it

[`POST /metadata/basic`](/docs/features/metadata) returns the title and duration for \$0.01. Use it to confirm a URL works, and how long the media is, before you start a bigger download or transcription.


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