twitch/
user-videos

Collectez une page de vidéos Twitch publiques pour un nom d’utilisateur, avec des filtres facultatifs de type et d’ordre, et obtenez contexte du créateur, médias, durée et engagement visible.

Twitch User Videos API

Vidéos de chaîne
Filtres par type
Engagement visible
0,19 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 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ètresObligatoireDescription
usernameObligatoireUn nom d’utilisateur Twitch public, pouvant commencer par @, composé de 1 à 64 lettres, chiffres, points, tirets bas ou traits d’union.
filter_byFacultatifType 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_byFacultatifOrdre 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.

  1. 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é.
  2. Envoyez username, filter_by et sort_by en POST à /v1/twitch/user-videos, puis conservez l’ID de tâche renvoyé.
  3. 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.
  4. 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=50

Cas 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.

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.

Explorer d’autres plateformes

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

Twitch User Videos API — FAQ

Twitch User Videos API est une interface programmatique qui collecte une page d’enregistrements de vidéos publiques d’un nom d’utilisateur Twitch. Elle renvoie l’identité normalisée des vidéos, la 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.

username est obligatoire et accepte un @ facultatif suivi de 1 à 64 lettres, chiffres, points, tirets bas ou traits d’union. filter_by accepte all, archive, archives, highlight, highlights, upload ou uploads ; sort_by accepte time ou views.

Chaque ReelVideoItem peut inclure un ID, une URL publique, une description, les détails du créateur, des médias, des hashtags, des mentions, la durée, les métadonnées audio, la date de publication, l’heure de collecte et les mentions « J’aime », commentaires, partages, lectures ou vues visibles. La disponibilité à la source détermine quels champs nullables contiennent une valeur.

Non. La spécification d’envoi effectue une seule requête à la source et n’accepte ni cursor ni results_limit. Une fois la tâche terminée, next_cursor peut parcourir les lignes de résultat déjà stockées pour cette tâche, mais il ne récupère pas une autre page source.

Chaque tâche réussie consomme un forfait de 0,19 crédit, quel que soit le nombre d’enregistrements renvoyés sur la page source.

Une tâche réussie peut ne contenir aucun élément lorsque la page source publique n’a aucun enregistrement éligible pour le type et l’ordre choisis, ou lorsque les vidéos correspondantes sont indisponibles. Traitez un résultat vide séparément d’une tâche en échec.