Twitch Profile
Un profil Twitch public peut exposer un nom d’utilisateur, un nom affiché, une biographie, des visuels de profil, un site web, des signaux de vérification ou de confidentialité, un contexte de localisation et les nombres visibles du compte. L’enregistrement de compte normalisé sert à enrichir des fiches de créateurs, à contrôler des profils et à produire des instantanés répétables de données publiques, sans gestion de chaîne ni action authentifiée sur le compte.
Fonctionnalités de la Twitch Profile API
- Recherche par nom d’utilisateur exactEnvoyez un nom d’utilisateur obligatoire de 1 à 64 caractères pris en charge, avec un seul @ initial facultatif.
- Identité publique normaliséeLisez l’ID du profil, l’URL publique, le nom d’utilisateur, le nom affiché, la biographie, l’avatar, l’image de couverture et le site web disponibles, dans la spécification AccountItem.
- Signaux d’état du compteConserve les indicateurs de vérification et de confidentialité disponibles dans des champs nullables, sans déduire de valeur lorsque le fournisseur ne les expose pas.
- Métriques de profil visiblesExploitez les nombres d’abonnés, d’abonnements et de publications disponibles, présentés comme des métriques facultatives distinctes et rattachées à l’heure de collecte.
- Flux de tâche asynchroneEnvoyez le nom d’utilisateur, conservez task_id, interrogez le lecteur de tâches commun, puis récupérez le résultat normalisé stocké après le succès.
- Facturation fixe par requêteUne tâche réussie coûte un montant fixe de 0,19 crédit SocQ, indépendamment de la disponibilité des champs facultatifs.
Paramètres de la Twitch Profile API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur Twitch obligatoire. Une fois les espaces supprimés, il peut commencer par un @ et doit ensuite contenir de 1 à 64 lettres ASCII, chiffres, points, tirets bas ou traits d’union. |
Comment utiliser la Twitch Profile API
Envoyez un nom d’utilisateur Twitch pris en charge, suivez la tâche asynchrone et lisez l’unique résultat de profil stocké grâce à la réponse à curseur commune.
- Choisissez un nom d’utilisateur Twitch public conforme à la règle de caractères prise en charge.
- Envoyez username en POST à /v1/twitch/profile et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- Lisez data.results.items ; la recherche de profil produit au plus un enregistrement source, tandis que l’enveloppe du résultat stocké comprend toujours has_more et next_cursor.
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 de la Twitch Profile API
- Enrichissement de fiches de créateurs : Ajoutez l’identité Twitch, la biographie, les visuels, le site web, les indicateurs de compte et les nombres publics disponibles à la fiche d’un créateur connu.
- Vérification de noms d’utilisateur : Résolvez un identifiant envoyé en profil public normalisé avant de le rattacher à une entité interne ou à un sujet d’étude.
- Comparaison de comptes publics : Comparez les nombres visibles d’abonnés, d’abonnements et de publications de noms d’utilisateur envoyés séparément, sous la même forme AccountItem.
- Surveillance des changements de profil : Stockez les champs d’identité nullables et les métriques avec collected_at, pour que chaque exécution ultérieure reste un instantané public distinct.
Conseils d’expert pour la Twitch Profile API
- Envoyez un nom d’utilisateur plutôt qu’une URL de chaîne Twitch ; url et results_limit ne sont pas des champs de requête acceptés par cet endpoint.
- N’utilisez qu’un seul @ initial facultatif ; les espaces, barres obliques, caractères non ASCII et @ répétés font échouer la règle de nom d’utilisateur du runtime.
- Attendez-vous à zéro ou un enregistrement de profil source. N’interprétez pas le paramètre limit du lecteur de tâches comme un moyen de transformer un profil en vidéos ou en abonnés.
- Considérez l’ID, l’URL, la biographie, les images, le site web, les indicateurs de compte, la localisation et chaque métrique comme nullables, et conservez collected_at pour comparer les instantanés.
- Utilisez des endpoints Twitch distincts pour les vidéos ou les clips lorsqu’ils sont disponibles ; cet endpoint est une recherche de profil en lecture seule, qui ne se connecte pas, ne publie pas, ne modère pas et ne gère aucune chaîne.
API associées
En complément de la Twitch Profile API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Twitch.
- Twitch User Videos API
- 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.