twitch/
clip

Récupère un clip Twitch public à partir de son URL et renvoie le titre, le nombre de vues, la durée, la date de création, le profil du streamer et un fichier MP4 direct avec sa miniature.

Twitch Clip Downloader API

URL de clip en entrée
Lien MP4 direct
Nombre de vues
Profil du streamer
0,5 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlObligatoireUn 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.

  1. Envoyez {"url": "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ"} en POST à /v1/twitch/clip.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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

Explorer d’autres plateformes

Combinez les données Twitch avec les données publiques d’autres plateformes sociales prises en charge.

Twitch Clip Downloader API — FAQ

Twitch Clip Downloader API est une interface programmatique qui récupère un clip Twitch public à partir de son URL de clip. Elle renvoie le titre, le nombre de vues, la durée, la date de création, le slug, le profil du streamer ainsi qu’un lien MP4 direct avec sa miniature.

Envoyez un lien de clip par requête, au format twitch.tv/chaine/clip/slug ou clips.twitch.tv/slug ; le format du lien est vérifié avant le lancement de la tâche.

Oui. media contient une adresse MP4 directe du clip ; elle est signée et expire au bout d’environ un jour, téléchargez donc le fichier peu après la fin de la tâche.

Le résultat standard regroupe le clip, ses métriques et le streamer. Le nom du jeu, le compte qui a découpé le clip et toutes les qualités vidéo disponibles se trouvent dans le fichier JSONL brut listé parmi les fichiers de la tâche.

Chaque requête lit un clip et coûte 0,5 crédit ; si le clip est introuvable, la tâche échoue et elle est intégralement remboursée.