twitch/
clip

The Twitch Clip Downloader API retrieves a public Twitch clip from its clip URL, returning the title, view count, length, creation time, broadcaster profile and a direct MP4 file with its thumbnail.

Twitch Clip Downloader API

Clip URL input
Direct MP4 link
View count
Broadcaster profile
0.5 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

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

  1. POST {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} to /v1/twitch/clip.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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

Explore other platforms

Combine Twitch data with public data from other supported social platforms.

Twitch Clip Downloader API — FAQ

Twitch Clip Downloader API is a programmatic interface for retrieving a public Twitch clip from its clip URL. It returns the clip title, view count, length, creation time, slug, broadcaster profile and a direct MP4 link with a thumbnail.

Submit one clip link per request, in the form twitch.tv/channel/clip/slug or clips.twitch.tv/slug; the link format is checked before the task starts.

Yes. media contains a direct MP4 address for the clip; it is signed and expires after roughly a day, so fetch the file soon after the task completes.

The standard result keeps the clip, its metrics and the broadcaster. The game name, the account that clipped it and every available video quality are kept in the raw JSONL file listed under the task's files.

Each Twitch Clip Downloader API request reads one clip and costs 0.5 credits; a clip that cannot be found fails the task with a full refund.