On this page5 sections
If your app works with Twitch content (a clip editor, an AI shorts tool, a highlights or moderation product, a stream archive), you need the video file behind a clip or VOD link. Twitch makes that harder than it looks:
- The official API gives you metadata, not files. Get Clips and Get Videos return titles, view counts, durations and thumbnails. They don't return a file you can download for any clip a user pastes.
- VODs are streams of segments. A past broadcast plays as a playlist of short video segments. You have to fetch every segment and join them before you have one file to store or edit.
- VODs expire. Twitch keeps past broadcasts for 7 days on most channels, 14 for Affiliates and 60 for Partners, Turbo and Prime. If your users paste VOD links, a job that fails today may have nothing to retry next week.
- It breaks on the server. Code that works from your laptop can get rate-limited or blocked once it runs from AWS, GCP, Fly or a serverless function, and Twitch changes the internals unofficial tools rely on.
The official route, if the channel is yours
Twitch's Helix API is the right choice for your own channel or for streamers who connect their Twitch account to your app. The Get Clips Download endpoint (open beta) returns download URLs for clips, but only on behalf of the broadcaster or one of their editors, with the editor:manage:clips or channel:manage:clips scope. Streamers can also download their own past broadcasts from the Video Producer page.
That works when the streamer signs in. It doesn't help when your users paste clips from channels they don't run, which is most clip and highlight tools.
For a handful of clips on your own machine, an open-source command-line downloader works and costs nothing. What it costs you is upkeep: updating it when Twitch changes something, joining VOD segments, and retries and error handling around it all.
One call with Importly
Importly takes the clip or VOD link your user pasted and returns the video as a single MP4.
curl https://api.importly.io/import \
-H "Authorization: Bearer $IMPORTLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.twitch.tv/<channel>/clip/<clip-slug>",
"videoQuality": "1080p",
"webhookUrl": "https://your.app/webhooks/import"
}'Clip links in the clips.twitch.tv/<slug> form and VOD links like https://www.twitch.tv/videos/<id> work the same way. When the job finishes, the webhook (or GET /import/status?id=<jobId>) gives you a signed link to the file plus the title, duration and thumbnail. The link lasts 7 days; set "store": true to have the file copied into your own S3, R2 or B2 bucket instead.
A few things worth knowing:
- Pick the resolution.
videoQualityis a ceiling (720pby default). Use1080pfor clips you'll re-edit, and480por lower for VODs you only analyse or transcribe. - Live streams wait. A stream that's still live fails with
LIVE_NOT_SUPPORTED. Submit the VOD link again after the stream ends. - Subscriber-only and deleted VODs fail fast with a clear
code, so you can tell the user instead of retrying. Failed imports aren't charged. - Transcripts: Twitch has no captions, so add
"includeTranscript": truewith"transcriptProvider": "importly"for AI speech-to-text at $0.01 a minute, or callPOST /transcribeon the link if you only need the text. - Check before you pay:
POST /metadata/basicreturns the title and duration for $0.003, so you can turn away an eight-hour VOD before downloading it. Or setmaxCostDollarsand Importly checks the price for you.
What it costs
Downloads are $0.002 per MB, with a $0.01 minimum per import. A 30-second clip at 720p is roughly 10 MB, about $0.02. A one-hour VOD at 720p is roughly 1 to 1.5 GB, about $2 to $3, and much less at 480p. 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 Twitch clip imports 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 a Twitch clip with the official API?
Only for channels you run or edit. The Get Clips Download endpoint returns clip files on behalf of the broadcaster or an editor. For clips from other channels, Get Clips gives you metadata and a thumbnail, not the video.
How do I download a Twitch VOD as one file?
A VOD plays as a playlist of short segments, so you have to fetch them all and join them. Importly returns the joined MP4 from the twitch.tv/videos/<id> link.
Why did my VOD link stop working?
Twitch deletes past broadcasts after 7 to 60 days depending on the channel, and streamers can delete them sooner. Import VODs you need soon after the stream.
Can I transcribe a Twitch stream?
Yes, once it has ended. Call POST /transcribe on the VOD or clip link with "provider": "importly". It's $0.01 a minute.
Related: Video downloader API, TikTok video download API, Downloads, Supported sites.