BlogCore API

Twitch Clip and VOD Download API: Get the Video From a Link

Twitch's API returns clip files only to the channel's own broadcaster or editors, and VODs expire. The official route for your own channel, and one Importly call for any public clip or VOD.

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.

bash
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. videoQuality is a ceiling (720p by default). Use 1080p for clips you'll re-edit, and 480p or 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": true with "transcriptProvider": "importly" for AI speech-to-text at $0.01 a minute, or call POST /transcribe on the link if you only need the text.
  • Check before you pay: POST /metadata/basic returns the title and duration for $0.003, so you can turn away an eight-hour VOD before downloading it. Or set maxCostDollars and 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.

Keep reading

Put video and audio links to work in your app

One API for files, transcripts and metadata. Free to try, no card required.

Try free →