Twitch Clip Downloader
A Twitch clip is a short highlight a viewer cuts from a live stream or VOD, carrying its own title, slug, view count, length, creation time, the broadcaster it came from and a rendered video with a thumbnail. Those details let you archive standout moments with their video, measure how far a clip has traveled, and credit the right channel when a highlight is reshared.
Twitch Clip Downloader API Features
- Both clip link formatsA link in the twitch.tv/channel/clip/slug form and a clips.twitch.tv/slug short link both resolve to the same clip, so links copied from chat, X or Discord work as they are.
- Playable MP4 and thumbnailIn the Twitch Clip Downloader API response, media holds a direct MP4 address for the clip together with its thumbnail_url, which is what you need to store or preview the highlight.
- Reach and timingmetrics.views_count, duration_seconds and published_at give the clip's view total, its length in seconds and the moment it was created.
- Broadcaster attachedauthor carries the streamer's ID, login, display name, channel link, avatar and partner status, so every clip arrives linked to the channel that aired it.
- Slug as a stable keyshortcode returns the clip slug and id the numeric clip ID, both of which stay fixed while titles and view counts change.
Twitch Clip Downloader API Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | One public Twitch clip link, either https://www.twitch.tv/<channel>/clip/<slug> or https://clips.twitch.tv/<slug>. |
How to Use the Twitch Clip Downloader API
Send one clip link to the Twitch Clip Downloader API and read the clip as a single row.
- POST {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} to /v1/twitch/clip.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the clip from results.items; has_more and results.next_cursor follow the usual paging rules and stay empty for this single row.
curl -X POST "https://api.socq.ai/v1/twitch/clip" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"}'Twitch Clip Downloader API Use Cases
- Archiving stream highlights: Save the MP4 from media together with the title, broadcaster and published_at to keep a searchable library of a channel's best moments.
- Tracking a clip's spread: Re-read the same clip over several days and chart metrics.views_count against collected_at to see how a highlight is picking up.
- Crediting reposted clips: Use author's login, display name and channel link to attribute a clip correctly before it appears in a compilation, newsletter or social post.
Twitch Clip Downloader API Pro Tips
- Download the MP4 soon after the task finishes, because the media address is signed and stops working after about a day.
- Key stored clips on shortcode or id instead of the URL you submitted, since one clip can be shared through both link formats.
- Store collected_at next to views_count whenever you refresh a clip so later readings stay comparable.
Related APIs
Beyond the Twitch Clip Downloader API, use these APIs when you need a different type of public Twitch data.
- Twitch Profile API — Resolve one public Twitch username into a normalized account record with available identity, biography, imagery, account flags, visible metrics, and collection context.
- Twitch User Videos API