Skip to main content
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

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.
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 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.