On this page6 sections
Course platforms, video tools and AI apps often get Vimeo links from their users: a lesson, a webinar recording, a talk. When you need the actual file or a transcript, there are two very different cases.
If the videos are yours: use Vimeo's API
If the videos belong to your own Vimeo account on a paid plan, the official API is the right tool. Request a video with your access token and its download field lists direct file links at each available quality. Pick one and download it. It's supported, it's stable, and it costs nothing beyond your plan.
If the videos are someone else's
This is the usual case when users paste links into your app, and it's where it gets harder:
- The API won't give you the file. Vimeo's download links are only returned to the video's owner. For anyone else's public video, the API gives you details but not the media.
- You end up parsing the player. The workaround is reading the stream URLs out of Vimeo's player, then fetching separate video and audio streams and joining them. It breaks when the player changes.
- It breaks on the server. Code that works on your laptop can get blocked or throttled from AWS, GCP, Fly, serverless functions or an agent sandbox.
- Private and password-protected videos need different handling from public ones, and your users won't know which they've sent you.
One call with Importly
Importly takes the Vimeo link your user pasted and gives you a single MP4 with sound, from servers and agent sandboxes.
curl https://api.importly.io/import \
-H "Authorization: Bearer $IMPORTLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://vimeo.com/<id>",
"webhookUrl": "https://your.app/webhooks/import"
}'When the job finishes, the webhook (or GET /import/status?id=<jobId>) gives you a signed link to the file plus its title, duration and thumbnail. The link lasts 7 days; set "store": true to have the file copied straight into your own S3, R2 or B2 bucket instead.
A few things worth knowing:
- Pick the quality you need.
videoQualityis a ceiling (720pby default;1080pand higher are available), and Importly takes the best stream at or below it. - Audio only: set
"includeVideo": falseto get just the soundtrack, which is usually all you need for transcription or a podcast feed. - Transcript: add
"includeTranscript": trueto get a timestamped transcript in the same job. If the video has no captions, add"transcriptProvider": "importly"for AI speech-to-text at $0.01 a minute. - Check before you pay:
POST /metadata/basicreturns the title and duration for $0.003, so you can confirm the link works and how long a webinar runs before downloading it. - Private and password-protected videos fail fast with
VIDEO_PRIVATEorAUTH_REQUIRED, so you can ask the user for a public link instead of retrying. Failed imports aren't charged.
What it costs
Downloads are $0.002 per MB, with a $0.01 minimum per import. A 10-minute video at 720p is around 77 MB, about $0.15. A one-hour webinar as audio only is far smaller. Set maxCostDollars on a request and Importly checks the price before downloading anything. New accounts get $3 of free credit, no card. See pricing for the full list.
Have your AI agent build it in
Connect https://mcp.importly.io/mcp to Claude Code, Cursor or another coding agent and ask it to add Vimeo downloads to your app. It gets working code for your stack, writes the integration and tests real calls with your API key, and your backend uses the same key. The steps are in Have your agent build Importly into your app.
FAQ
Can I download Vimeo videos with the Vimeo API?
Only videos you own, on a paid Vimeo plan. The API returns download links to the video's owner. For other people's public videos it doesn't return the file.
Can Importly download private Vimeo videos?
No. Private and password-protected videos fail with VIDEO_PRIVATE or AUTH_REQUIRED. Use Vimeo's own API for videos in your account.
Can I get a transcript of a Vimeo video?
Yes. Use POST /transcribe with the link, or add includeTranscript to an import to get the file and the transcript from one job.
Can I get just the audio?
Yes. Set includeVideo to false and you get the audio track only.
Related: Video downloader API, X (Twitter) video download API, Supported sites, Importly docs.