Twitch Clip Downloader
Un clip Twitch est un court temps fort qu’un spectateur extrait d’un live ou d’une VOD, avec son propre titre, son slug, son nombre de vues, sa durée, sa date de création, le streamer d’origine ainsi qu’une vidéo rendue et sa miniature. Ces éléments servent à archiver les meilleurs moments avec leur vidéo, à mesurer la diffusion d’un clip et à créditer la bonne chaîne lorsqu’un extrait est repartagé.
Fonctionnalités de la Twitch Clip Downloader API
- Les deux formats de lien de clipUn lien twitch.tv/chaine/clip/slug comme un lien court clips.twitch.tv/slug mènent au même clip, si bien qu’un lien copié depuis le chat, X ou Discord s’utilise tel quel.
- MP4 lisible et miniaturemedia contient l’adresse MP4 directe du clip et son thumbnail_url, soit tout ce qu’il faut pour stocker ou prévisualiser le temps fort.
- Audience et chronologiemetrics.views_count, duration_seconds et published_at donnent le total de vues, la durée en secondes et le moment où le clip a été créé.
- Streamer rattachéauthor fournit l’ID, l’identifiant, le nom affiché, le lien de chaîne, l’avatar et le statut de partenaire du streamer, ce qui relie chaque clip à la chaîne qui l’a diffusé.
- Le slug comme clé stableshortcode renvoie le slug du clip et id son identifiant numérique, deux valeurs qui ne bougent pas quand le titre ou les vues changent.
Paramètres de la Twitch Clip Downloader API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | Un lien de clip Twitch public, au format https://www.twitch.tv/<channel>/clip/<slug> ou https://clips.twitch.tv/<slug>. |
Comment utiliser la Twitch Clip Downloader API
Envoyez un lien de clip et lisez le clip sous forme d’une ligne unique.
- Envoyez {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} en POST à /v1/twitch/clip.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez le clip dans results.items ; has_more et results.next_cursor suivent les règles de pagination habituelles et restent vides pour cette ligne unique.
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"}'Cas d’usage de la Twitch Clip Downloader API
- Archiver les temps forts d’un live : Conservez le MP4 de media avec le titre, le streamer et published_at pour constituer une bibliothèque consultable des meilleurs moments d’une chaîne.
- Suivre la diffusion d’un clip : Relisez le même clip pendant plusieurs jours et tracez metrics.views_count en fonction de collected_at pour voir si un extrait décolle.
- Créditer les clips repartagés : Utilisez l’identifiant, le nom affiché et le lien de chaîne de author pour attribuer correctement un clip avant de l’intégrer à une compilation, une newsletter ou un post.
Conseils d’expert pour la Twitch Clip Downloader API
- Téléchargez le MP4 peu après la fin de la tâche, car l’adresse de media est signée et cesse de fonctionner au bout d’un jour environ.
- Indexez les clips enregistrés sur shortcode ou id plutôt que sur l’URL envoyée, puisqu’un même clip circule sous deux formats de lien.
- Enregistrez collected_at à côté de views_count à chaque actualisation pour garder des relevés comparables.
API associées
En complément de la Twitch Clip Downloader API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Twitch.
- Twitch Profile API — Transformez un nom d’utilisateur Twitch public en fiche de compte normalisée, avec identité, biographie, visuels, indicateurs de compte, métriques visibles et contexte de collecte disponibles.
- Twitch User Videos API