twitch/
clip

Recupera una clip pubblica di Twitch dal suo URL e restituisce titolo, visualizzazioni, durata, data di creazione, profilo dello streamer e un file MP4 diretto con la relativa miniatura.

Twitch Clip Downloader API

URL della clip in ingresso
Link MP4 diretto
Visualizzazioni
Profilo dello streamer
0,5 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlObbligatorioUn 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.

  1. Invia {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} in POST a /v1/twitch/clip.
  2. Interroga GET /v1/tasks/{task_id} finché status non è succeeded.
  3. 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.

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

Esplora altre piattaforme

Combina i dati di Twitch con i dati pubblici delle altre piattaforme social supportate.

Twitch Clip Downloader API — FAQ

Twitch Clip Downloader API è un’interfaccia programmatica che recupera una clip pubblica di Twitch a partire dal suo URL. Restituisce titolo, visualizzazioni, durata, data di creazione, slug, profilo dello streamer e un link MP4 diretto con la relativa miniatura.

Invia un link di clip per richiesta, nel formato twitch.tv/canale/clip/slug oppure clips.twitch.tv/slug; il formato del link viene verificato prima che l’attività venga creata.

Sì. media contiene un indirizzo MP4 diretto della clip; è firmato e scade dopo circa un giorno, quindi conviene scaricare il file appena l’attività è terminata.

Il risultato standard riunisce clip, metriche e streamer. Il nome del gioco, l’account che ha ritagliato la clip e tutte le qualità video disponibili si trovano nel file JSONL grezzo elencato tra i file dell’attività.

Ogni richiesta legge una clip e costa 0,5 crediti; se la clip non viene trovata, l’attività fallisce e viene rimborsata per intero.