YouTube Channel Live Videos
Les diffusions d’une chaîne YouTube sont des entrées publiques affichées dans son onglet live, avec l’identité de la vidéo, le contexte de la chaîne, les miniatures, les horodatages et l’engagement visible. Selon ce que YouTube expose pour la chaîne, la collecte peut contenir des diffusions en cours, à venir ou archivées, sans garantie d’un libellé d’état normalisé.
Fonctionnalités de la YouTube Channel Live Videos API
- URL de chaîne canoniques acceptéesRésolution des URL YouTube publiques de forme /@handle, /channel/{id}, /c/{name} et /user/{name}.
- Découverte dans l’onglet liveCollecte des entrées de diffusion proposées dans l’onglet live de chaque chaîne envoyée.
- Profondeur de collecte par chaîneDe 20 à 2 000 enregistrements demandés pour chaque chaîne fournie, 100 par défaut.
- Enregistrements de diffusion normalisésIdentité de la vidéo, titre, description, chaîne, miniature, durée, hashtags, date de publication et contexte source, lorsqu’ils sont disponibles.
- Instantanés d’engagement visibleLes nombres publics de vues, de mentions « J’aime » et de commentaires sont saisis avec collected_at pour une analyse à un instant donné.
- Livraison asynchrone des résultatsInterrogez l’état de la tâche, conservez son ID et utilisez la pagination par curseur pour récupérer les résultats de façon fiable.
Paramètres de la YouTube Channel Live Videos API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de chaînes YouTube publiques séparées par des virgules ou des retours à la ligne. Les chemins pris en charge sont /@handle, /channel/{id}, /c/{name} et /user/{name}. |
results_limit | Facultatif | Nombre maximal d’enregistrements demandés pour chaque URL de chaîne. Doit être un entier de 20 à 2 000 ; vaut 100 par défaut. |
Comment utiliser la YouTube Channel Live Videos API
Envoyez des URL de chaînes publiques canoniques et choisissez une profondeur de collecte pour chacune. La requête crée une tâche asynchrone : la fin du traitement et la lecture des résultats sont deux étapes distinctes.
- Préparez une ou plusieurs URL de chaînes YouTube publiques utilisant un chemin pris en charge : identifiant @, ID de chaîne, nom personnalisé ou utilisateur.
- Envoyez urls et results_limit en POST à /v1/youtube/channel-live-videos et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
- Lisez les pages de résultats sur /v1/tasks/{task_id}?limit=50 et renvoyez next_cursor dans cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-live-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50&cursor={next_cursor}Cas d’usage de la YouTube Channel Live Videos API
- Constitution d’un inventaire de diffusions : Dressez une liste structurée des diffusions publiques rattachées aux chaînes de votre sélection.
- Étude de la programmation en direct : Comparez titres, horaires, durées et rythmes de publication entre des chaînes qui proposent des lives réguliers.
- Veille sur les diffusions de créateurs : Repérez quelles diffusions publiques sont visibles sur les chaînes de créateurs, de marques, d’éditeurs ou de concurrents.
- Instantanés de performance après diffusion : Stockez les vues, mentions « J’aime » et commentaires visibles avec l’heure de collecte pour comparer plus tard les tendances.
- Enrichissement d’un catalogue de médias publics : Ajoutez des métadonnées de diffusion normalisées et le contexte de la chaîne source à vos outils de recherche, de reporting ou de classification.
Conseils d’expert pour la YouTube Channel Live Videos API
- results_limit s’applique à chaque chaîne. Cinq URL avec une limite de 100 demandent jusqu’à 500 enregistrements avant le dédoublonnage à l’échelle de la tâche.
- Utilisez des URL de chaîne canoniques avec un identifiant @, un ID de chaîne, un nom personnalisé ou un nom d’utilisateur non vide ; un simple chemin /channel ne permet pas de résoudre une source.
- Considérez l’onglet live de la chaîne comme la limite d’éligibilité. La présence de diffusions en cours, à venir ou archivées peut changer d’une collecte à l’autre.
- N’en déduisez pas un état fiable (en cours, à venir ou archivé) à partir de type ou de extra.content_type : la charge normalisée n’a pas de champ dédié à l’état du live.
- La réponse contient des métadonnées et des références de miniatures, pas le chat en direct, ni l’URL d’un flux lisible, ni les sous-titres, ni le texte d’une transcription.
- Des entrées de chaîne équivalentes peuvent faire découvrir la même vidéo. Les résultats de tâche sauvegardés sont dédoublonnés par ID de vidéo normalisé, puis par URL en l’absence d’ID.
- La limite de lecture des résultats d’une tâche est distincte de results_limit : demandez de 1 à 500 lignes sauvegardées par page et réutilisez le next_cursor opaque jusqu’à ce que has_more vaille false.
- Des métadonnées publiques ne donnent pas accès à un visionnage privé ou réservé aux membres. Conservez extra.is_members_only lorsque la source signale cette classification.
API associées
En complément de la YouTube Channel Live Videos 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 Channels API — Récupérez l’identité publique d’une chaîne, ses images, sa vérification et ses statistiques d’audience visibles.
- YouTube Videos API — Récupérez les métadonnées, miniatures, durée et l’engagement à partir d’URL de vidéos ou de Shorts connues.
- YouTube Shorts API — Collectez par chaîne les Shorts publics, miniatures, durée, informations de publication et l’engagement.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts 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 Email Finder API
- YouTube Trending Videos API