Retour aux API
Données publiques Twitch

Twitch Public Data API

Transformez un nom d’utilisateur Twitch public connu en profil normalisé, collectez son inventaire de vidéos publiques ou récupérez un clip avec sa vidéo téléchargeable pour l’étude des créateurs, l’enrichissement de catalogues, la comparaison et le suivi par instantanés.

API Twitch disponibles

Utilisez Twitch Profile API pour l’identité normalisée d’un compte, Twitch User Videos API pour une page de vidéos publiques avec les filtres de type et de tri pris en charge, ou Twitch Clip Downloader API pour un clip public à partir de son URL.

Quelles données Twitch pouvez-vous récupérer ?

Le catalogue Twitch renvoie un enregistrement public normalisé de compte ou une page de vidéos publiques normalisées à partir d’un nom d’utilisateur, ou un clip public à partir de son URL, avec des champs nullables lorsque la source n’expose pas de valeur.

Identité du profil

Récupérez l’ID du compte, l’URL publique, le nom d’utilisateur, le nom affiché et la biographie, lorsqu’ils sont disponibles.

Présentation du profil

Conservez l’avatar, l’image de couverture et le site web associé, lorsqu’ils sont disponibles.

Signaux du compte

Lisez les indicateurs nullables de compte vérifié et de compte privé, sans déduire les valeurs absentes.

Nombres visibles du compte

Gardez les nombres disponibles d’abonnés, d’abonnements et de publications à côté de collected_at pour des comparaisons à un instant donné.

Vidéos publiques d’un utilisateur

Collectez l’identité de la vidéo, le contexte du créateur, les médias, la durée, la date de publication et l’engagement visible à partir d’une page source.

Clips publics

Récupérez le titre, les vues, la durée, la date de création et le streamer d’un clip, ainsi qu’un lien MP4 téléchargeable avec sa miniature.

SocQ vs Twitch API

SocQ propose la récupération de profils publics, de vidéos d’utilisateurs et de clips dans des flux de tâches normalisés ; les API natives de Twitch et leur authentification conviennent aux intégrations d’applications autorisées et aux opérations sur les chaînes.

FonctionnalitéSocQTwitch API
Usage principalRésoudre un profil public, collecter une page de vidéos d’un utilisateur ou récupérer un clipCréer des intégrations Twitch natives autour des ressources Twitch
AuthentificationClé API SocQApplication Twitch et autorisation utilisateur ou application applicable
Entrée de départUn nom d’utilisateur, ou une URL de clip pour les clipsParamètres de requête natifs et identifiants de ressources Twitch
Gestion de chaîneNon prise en chargePassez par les API Twitch autorisées et les permissions requises
Format de réponseEnregistrements SocQ AccountItem ou ReelVideoItem normalisésObjets de réponse natifs de Twitch

Fonctionnement de l’API Twitch

Toutes les API Twitch utilisent le flux commun de SocQ : tâche asynchrone, puis résultat stocké.

  1. 1. Choisir un endpoint

    Envoyez en POST un nom d’utilisateur public valide à /v1/twitch/profile ou à /v1/twitch/user-videos, ou une URL de clip à /v1/twitch/clip, et conservez le task_id.

  2. 2. Suivre la tâche

    Interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec de la tâche.

  3. 3. Lire les enregistrements stockés

    Utilisez data.results.items pour les enregistrements de profil ou de vidéos et conservez le contexte de la date de collecte.

Résoudre un profil Twitch public

Authentifiez-vous avec une clé API SocQ et envoyez un seul nom d’utilisateur pris en charge. La tâche réussie a un coût fixe de 0,19 crédit.

curl -X POST "https://api.socq.ai/v1/twitch/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"ninja"}'

# Poll GET /v1/tasks/{task_id}
# Read the normalized account in data.results.items

Cas d’usage courants de l’API Twitch

Enrichissement de l’identité des créateurs

Ajoutez l’identité Twitch, la biographie, les images, le site web, les indicateurs de compte et les nombres publics disponibles à vos fiches de créateurs connus.

Résolution de pseudos

Résolvez un nom d’utilisateur envoyé avant de rattacher le profil public à une entité de recherche interne.

Comparaison de comptes

Comparez des profils collectés séparément grâce aux mêmes champs nullables d’identité et d’indicateurs.

Suivi par instantanés

Conservez collected_at avec les valeurs publiques du profil afin que les exécutions suivantes restent des instantanés distincts.

Enrichissement de l’inventaire vidéo

Rattachez l’identité des vidéos publiques, les médias, le contexte du créateur, la durée, les horodatages et l’engagement visible à des chaînes connues.

Archivage des temps forts

Conservez le MP4 d’un clip avec son titre, son streamer et sa date de création pour constituer une bibliothèque consultable des meilleurs moments d’une chaîne.

Limites et politique sur les données publiques

Les endpoints Twitch sont des consultations en lecture seule de profils publics, de vidéos d’utilisateurs et de clips. Ils n’offrent ni actions authentifiées sur les chaînes ni données sur les membres de l’audience.

  • Profile et User Videos n’acceptent qu’un seul nom d’utilisateur ; ils n’acceptent ni URL de chaîne, ni liste de noms, ni results_limit.
  • Twitch Clip Downloader accepte une URL de clip au format twitch.tv/<channel>/clip/<slug> ou clips.twitch.tv/<slug> ; le lien MP4 renvoyé est signé et expire au bout d’un jour environ.
  • Le nom d’utilisateur peut commencer par un seul @ et doit sinon contenir de 1 à 64 caractères ASCII : lettres, chiffres, points, tirets bas ou tirets.
  • La consultation de profil renvoie au plus un objet de profil source ; User Videos collecte une page source et n’accepte ni curseur ni results_limit contrôlés par l’appelant.
  • L’identité, les images, le site web, les indicateurs, la localisation et les indicateurs individuels du profil peuvent être null lorsque les données publiques de la source sont indisponibles.
  • L’endpoint ne se connecte pas, ne publie pas, ne modère pas, ne gère pas de chaîne, ne récupère pas d’analyses privées et n’effectue aucune action de compte autorisée par OAuth.

Questions fréquentes sur l’API Twitch

Qu’est-ce que l’API Twitch ?

Les API Twitch utilisent des tâches asynchrones pour transformer un nom d’utilisateur public connu en profil normalisé, pour collecter une page de ses vidéos publiques ou pour récupérer un clip public à partir de son URL.

Quelles API Twitch sont actuellement disponibles ?

Twitch Profile API, Twitch User Videos API et Twitch Clip Downloader API sont actuellement disponibles.

Puis-je envoyer une URL Twitch ?

Twitch Clip Downloader API accepte une URL de clip dans url. Twitch Profile et User Videos exigent username et rejettent url, urls et tout autre champ non déclaré.

Cette API gère-t-elle une chaîne Twitch ?

Non. Tous les endpoints Twitch sont des consultations publiques en lecture seule : ils n’authentifient aucun utilisateur Twitch, ne publient pas, ne modèrent pas, ne gèrent pas les réglages de chaîne et ne récupèrent pas d’analyses privées.

Pourquoi certains champs peuvent-ils être null ?

Les enregistrements normalisés de comptes et de vidéos conservent les champs publics facultatifs à null lorsque la source ou le fournisseur n’expose pas de valeur au moment de la collecte.

Comment les requêtes Twitch sont-elles facturées ?

Chaque tâche Twitch Profile ou User Videos réussie coûte un montant fixe de 0,19 crédit SocQ. Chaque requête Twitch Clip Downloader coûte 0,5 crédit, et un clip introuvable est intégralement remboursé.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.