Twitch Clip Downloader
Una clip di Twitch è un breve momento saliente che uno spettatore ritaglia da una diretta o da un VOD, con titolo, slug, visualizzazioni, durata, data di creazione, streamer d’origine, video renderizzato e miniatura propri. Questi dati servono ad archiviare i momenti migliori insieme al video, a misurare quanto si diffonde una clip e a citare il canale giusto quando viene ricondivisa.
Funzionalità della Twitch Clip Downloader API
- Entrambi i formati di linkUn link twitch.tv/canale/clip/slug e un link breve clips.twitch.tv/slug portano alla stessa clip, quindi puoi inviare così com’è ciò che copi dalla chat, da X o da Discord.
- MP4 riproducibile con miniaturamedia contiene l’indirizzo MP4 diretto della clip e il relativo thumbnail_url, cioè tutto ciò che serve per salvare o mostrare in anteprima il momento saliente.
- Portata e momento di creazionemetrics.views_count, duration_seconds e published_at riportano le visualizzazioni totali, la durata in secondi e l’istante in cui la clip è stata creata.
- Streamer collegatoauthor fornisce ID, nome utente, nome visualizzato, link al canale, avatar e stato di partner dello streamer, così ogni clip resta legata al canale che l’ha trasmessa.
- Lo slug come chiave stabileshortcode restituisce lo slug della clip e id il suo identificativo numerico, due valori che restano invariati anche quando cambiano titolo o visualizzazioni.
Parametri della Twitch Clip Downloader API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | Un link pubblico a una clip di Twitch, nel formato https://www.twitch.tv/<channel>/clip/<slug> oppure https://clips.twitch.tv/<slug>. |
Come usare la Twitch Clip Downloader API
Invia il link di una clip e leggila come singola riga di risultato.
- Invia {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} in POST a /v1/twitch/clip.
- Interroga GET /v1/tasks/{task_id} finché status non è succeeded.
- Leggi la clip in results.items; has_more e results.next_cursor seguono le normali regole di paginazione e restano vuoti per questa singola riga.
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"}'Casi d’uso della Twitch Clip Downloader API
- Archiviare i momenti migliori: Salva l’MP4 di media con titolo, streamer e published_at per creare una raccolta consultabile dei momenti salienti di un canale.
- Seguire la diffusione di una clip: Rileggi la stessa clip per alcuni giorni e traccia metrics.views_count rispetto a collected_at per capire se un momento sta prendendo piede.
- Citare correttamente le clip condivise: Usa nome utente, nome visualizzato e link al canale di author per attribuire bene una clip prima di inserirla in una compilation, in una newsletter o in un post.
Consigli degli esperti per la Twitch Clip Downloader API
- Scarica l’MP4 poco dopo la fine dell’attività, perché l’indirizzo in media è firmato e smette di funzionare dopo circa un giorno.
- Usa shortcode o id come chiave delle clip salvate invece dell’URL inviato, dato che la stessa clip circola con due formati di link.
- Registra collected_at accanto a views_count a ogni aggiornamento, così le letture successive restano confrontabili.
API correlate
Oltre alla Twitch Clip Downloader API, usa queste API quando ti serve un altro tipo di dati pubblici di Twitch.
- Twitch Profile API — Trasforma un nome utente Twitch pubblico in un record di account normalizzato con identità, bio, immagini, flag dell’account, metriche visibili e contesto della raccolta, se disponibili.
- Twitch User Videos API