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é | SocQ | Twitch API |
|---|---|---|
| Usage principal | Résoudre un profil public, collecter une page de vidéos d’un utilisateur ou récupérer un clip | Créer des intégrations Twitch natives autour des ressources Twitch |
| Authentification | Clé API SocQ | Application Twitch et autorisation utilisateur ou application applicable |
| Entrée de départ | Un nom d’utilisateur, ou une URL de clip pour les clips | Paramètres de requête natifs et identifiants de ressources Twitch |
| Gestion de chaîne | Non prise en charge | Passez par les API Twitch autorisées et les permissions requises |
| Format de réponse | Enregistrements SocQ AccountItem ou ReelVideoItem normalisés | Objets 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. 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. Suivre la tâche
Interrogez /v1/tasks/{task_id} jusqu’à la réussite ou l’échec de la tâche.
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.
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.itemsCas 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é.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
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.
Rednote API
Récupérez des profils et des notes publics, recherchez des notes ou des utilisateurs, collectez les commentaires et leurs réponses imbriquées, et capturez une page de recommandations de la page d’accueil.
Kwai API
Récupérez des profils Kwai publics, une page de publications d’un compte ou une publication connue, avec identité, contenu, médias, horodatages et engagement visible normalisés.
Truth Social API
Récupérez les détails d’un compte public, collectez une page source de publications d’un compte ou transformez l’URL d’une publication connue en enregistrements normalisés.
Google Ad Library API
Découvrez des annonceurs publics, collectez les créations d’une entreprise ou récupérez par URL une création connue du Transparency Center, pour la recherche et la vérification.
Google Maps API
Découvrez des lieux publics, récupérez des détails normalisés à partir d’URL Maps connues et collectez des avis publics avec le contexte du lieu et de l’auteur relié à la source.
Amazon API
Recherchez des produits Amazon publics et collectez des détails de produits, Best Sellers, avis, profils de vendeurs et vitrines de créateurs normalisés sur les places de marché prises en charge.


