Twitch User Videos
Les vidéos d’une chaîne Twitch publique regroupent ses archives, ses temps forts et ses vidéos importées, avec descriptions, contexte du créateur, références média, durée, date de publication et engagement visible. Ces enregistrements servent à cataloguer une chaîne, à comparer les formats, à étudier le rythme de publication et à produire des rapports de performance à un instant donné.
Fonctionnalités de la Twitch User Videos API
- Inventaire limité à un nom d’utilisateurTransforme un nom d’utilisateur Twitch public en enregistrements des vidéos renvoyées pour cette chaîne lors d’une unique requête à la source.
- Filtres archive, highlight et uploadSélectionnez toutes les vidéos ou restreignez la requête source avec les valeurs archive, highlight ou upload acceptées, ainsi que leurs alias au pluriel.
- Tri par date ou par vuesOrdonnez la page source renvoyée par date ou par nombre de vues visibles, pour repérer les publications récentes ou les vidéos les plus vues.
- Enregistrements vidéo normalisésRenvoie l’identité de la vidéo, son URL publique, sa description, le contexte du créateur, les médias, la durée, la date de publication, les métadonnées audio et l’engagement visible dans la structure ReelVideoItem.
Paramètres de la Twitch User Videos API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Un nom d’utilisateur Twitch public, pouvant commencer par @, composé de 1 à 64 lettres, chiffres, points, tirets bas ou traits d’union. |
filter_by | Facultatif | Type de source facultatif : all, archive, archives, highlight, highlights, upload ou uploads. Les alias au singulier et au pluriel correspondent à la même catégorie du fournisseur. |
sort_by | Facultatif | Ordre de source facultatif : time ou views. |
Comment utiliser la Twitch User Videos API
Envoyez un nom d’utilisateur Twitch avec, au choix, un type de vidéo et un tri, puis lisez l’unique page source dans le flux de tâche asynchrone habituel.
- Choisissez un nom d’utilisateur Twitch public et décidez si la page source doit couvrir toutes les vidéos ou un seul type de vidéo accepté.
- Envoyez username, filter_by et sort_by en POST à /v1/twitch/user-videos, puis conservez l’ID de tâche renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue ; ne renvoyez pas la requête une fois l’ID de tâche obtenu.
- Lisez les enregistrements ReelVideoItem dans results.items et n’utilisez next_cursor que pour parcourir les lignes de tâche déjà stockées.
curl -X POST "https://api.socq.ai/v1/twitch/user-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"ninja","filter_by":"all","sort_by":"time"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Cas d’usage de la Twitch User Videos API
- Catalogage des vidéos d’une chaîne : Servez-vous des ID de vidéos, URL publiques, descriptions, références média, durées et du contexte du créateur pour bâtir l’inventaire à jour d’une chaîne connue.
- Bilan de la répartition des formats : Lancez séparément les filtres de type acceptés et comparez les archives, temps forts et vidéos importées selon leur date de publication et leur durée.
- Instantanés de publication et de vues : Associez les horodatages de publication aux métriques de vues ou de lecture visibles et à collected_at pour consigner un instantané de la chaîne à un moment donné.
Conseils d’expert pour la Twitch User Videos API
- Pour le nom d’utilisateur, retirez les URL de profil et ne gardez que le @ facultatif et les 1 à 64 caractères acceptés.
- Utilisez time pour repérer les publications récentes et views pour repérer les vidéos les plus vues dans la page source renvoyée.
- Choisissez une forme, singulier ou pluriel, pour les alias de type et tenez-vous-y dans vos requêtes enregistrées, car chaque paire correspond à la même catégorie côté source.
- N’ajoutez ni cursor ni results_limit à la charge utile d’envoi : l’appel au fournisseur renvoie une seule page, et le curseur de résultats de la tâche ne parcourt que des lignes déjà stockées par SocQ.
- Dédoublonnez les collectes étalées dans le temps par ID de vidéo et acceptez que le texte, les médias, l’audio, l’auteur, les horodatages et les métriques soient nullables.
API associées
En complément de la Twitch User Videos 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 Clip Downloader API — Récupérez un clip Twitch public à partir de son URL, avec titre, vues, durée, date de création, profil du streamer et lien MP4 téléchargeable accompagné de sa miniature.