YouTube Channels
Une chaîne YouTube est la page publique d’un créateur, d’une marque ou d’une organisation : identité, descriptions, images, vérification, liens de profil et totaux visibles d’abonnés, de vidéos et de vues. Ces signaux de chaîne alimentent la recherche de créateurs, la comparaison d’audiences, l’enrichissement d’annuaires et l’analyse de marché.
Fonctionnalités de la YouTube Channels API
- Collecte de profils sur plusieurs chaînesRécupérez en une seule requête les profils publics de plusieurs URL de chaînes.
- Identité de chaîne normaliséeID de la chaîne, identifiant, nom affiché, URL canonique, description, avatar et bannière sont renvoyés dans une structure homogène.
- Indicateurs publics de la chaîneStatut de vérification, nombre public d’abonnés, nombre de vidéos publiées et total des vues de la chaîne.
- Champs de contexte du profilLocalisation publique, liens du profil, date de création de la chaîne et URL de chaîne soumise sont conservés.
- Horodatage de collectecollected_at s’ajoute à chaque résultat, afin de comparer les enregistrements stockés d’une date de collecte à l’autre.
Paramètres de la YouTube Channels API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de chaînes YouTube publiques, séparées par des virgules ou des retours à la ligne. |
Comment utiliser la YouTube Channels API
Transformez une liste de pages de chaînes publiques en enregistrements d’identité durables. La requête est asynchrone : gardez l’ID de tâche jusqu’à ce que chaque chaîne envoyée ait été résolue.
- Constituez une liste dédoublonnée d’URL de chaînes ou d’URL @handle publiques, sans URL de lecture de vidéo.
- Envoyez le tableau urls en POST à /v1/youtube/channels et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} ; queued et running sont des états intermédiaires normaux.
- Quand la tâche réussit, indexez data.results.items par id et poursuivez avec next_cursor si has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"]}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Cas d’usage de la YouTube Channels API
- Annuaires de créateurs et de marques : Enrichissez un annuaire avec des ID de chaîne stables, des détails de profil, des images, des liens et des indicateurs d’audience publics.
- Qualification de créateurs : Examinez les descriptions, la vérification, la taille de l’audience publique, l’activité de publication et les liens du profil au moment d’évaluer des partenaires potentiels.
- Comparaison de chaînes : Confrontez les nombres publics d’abonnés, de vidéos et de vues de créateurs, de marques, de médias ou de concurrents.
- Suivi des profils : Collectez les mêmes chaînes au fil du temps pour repérer les évolutions des détails de profil publics et des statistiques d’audience.
Conseils d’expert pour la YouTube Channels API
- Stockez id comme clé primaire. L’identifiant sert à l’affichage et au routage, mais il peut changer sans qu’une nouvelle chaîne soit créée.
- Ne convertissez pas un nombre d’abonnés masqué en 0. Null signifie que la valeur n’était pas publique, ce qui est un signal métier différent.
- Traitez les liens de la description comme des URL externes non fiables. Validez-les et nettoyez-les avant de les afficher dans un outil interne.
- Ne comparez les compteurs d’audience que si collected_at est présent, et gardez un rythme de collecte constant pour calculer des tendances.
- Un lot réussi peut contenir moins d’enregistrements que d’URL si une chaîne a été supprimée, restreinte ou n’est plus publique.
- Associez Channels à Channel Videos ou à Shorts par l’ID de chaîne, au lieu de répéter les champs de profil sur chaque ligne de contenu.
API associées
En complément de la YouTube Channels API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques YouTube.
- YouTube Channel Videos API — Collectez les vidéos publiques classiques à partir d’URL de chaînes, hors Shorts et lives.
- YouTube Comments API — Collectez les commentaires publics, auteurs, l’engagement, vidéos sources et le contexte de la conversation.
- YouTube Transcripts API — Récupérez les transcriptions en texte brut disponibles, avec choix facultatif de la langue.
- YouTube Shorts API — Collectez par chaîne les Shorts publics, miniatures, durée, informations de publication et l’engagement.
- YouTube Community Posts API — Collectez les publications publiques de l’onglet Communauté à partir d’URL de chaînes, avec texte, identité de la chaîne, horodatages, références d’images et contexte source.
- YouTube Email Finder API — Trouvez les e-mails professionnels publics d’une chaîne à partir de son URL, avec les pages où figure chaque adresse.
- YouTube Videos API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Trending Videos API