youtube/
channel-videos

Collectez les vidéos publiques classiques à partir d’URL de chaînes YouTube, avec titres, miniatures, durée, informations de publication, contexte de la chaîne et indicateurs d’engagement normalisés.

YouTube Channel Videos API

Vidéos de chaîne
Mises en ligne classiques
Indicateurs publics
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

YouTube Channel Videos

Les vidéos d’une chaîne YouTube sont ses mises en ligne classiques, accompagnées de titres, de descriptions, de miniatures, de la durée, d’informations de publication et de l’engagement visible. Ces enregistrements servent à cataloguer une chaîne, à analyser sa fréquence de publication, à surveiller ses contenus et à produire des rapports sur la durée.

Fonctionnalités de la YouTube Channel Videos API

  • Collecte de vidéos sur plusieurs chaînesRécupérez les vidéos publiques classiques de plusieurs URL de chaînes en une seule requête.
  • Limite de résultats propre à chaque chaîneDéfinissez un results_limit distinct pour chaque chaîne fournie, 100 par défaut.
  • Métadonnées vidéo normaliséesRenvoie l’identité normalisée de la vidéo, ses métadonnées de contenu, ses miniatures, sa durée, sa date de publication et la chaîne qui l’a publiée.
  • Indicateurs d’engagement à un instant donnéLes nombres publics de vues, de mentions « J’aime » et de commentaires sont fournis avec collected_at pour permettre des comparaisons ultérieures.
  • Périmètre limité aux vidéos classiquesLes Shorts et les lives sont exclus afin que le résultat reste centré sur les vidéos classiques de la chaîne.

Paramètres de la YouTube Channel Videos API

ParamètresObligatoireDescription
urlsObligatoireURL de chaînes YouTube publiques, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal d’enregistrements éligibles à demander pour chaque URL fournie. Doit être un entier positif ; vaut 100 par défaut.

Comment utiliser la YouTube Channel Videos API

Décidez jusqu’où explorer chaque chaîne, puis collectez un inventaire propre de vidéos classiques. Un lot peut regrouper plusieurs chaînes, mais la limite demandée s’applique à chacune d’elles.

  1. Préparez les URL de chaînes publiques et déterminez si vous voulez un échantillon récent ou un rattrapage plus profond de l’historique.
  2. Envoyez urls et results_limit en POST à /v1/youtube/channel-videos ; n’oubliez pas que la limite s’applique par chaîne.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche d’inventaire atteigne succeeded ou failed.
  4. Regroupez les éléments renvoyés par ID de chaîne, dédoublonnez par ID de vidéo et paginez tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Cas d’usage de la YouTube Channel Videos API

  • Flux de contenus de chaînes : Alimentez un flux structuré avec les vidéos publiques classiques des chaînes que vous avez choisies.
  • Analyse de la publication et des performances : Comparez d’une chaîne à l’autre la fréquence de publication, la durée, les sujets et l’engagement public.
  • Veille sur les créateurs et les concurrents : Suivez l’activité vidéo classique de créateurs, d’éditeurs, de marques ou de concurrents.
  • Création d’un catalogue de vidéos : Alimentez des workflows de classification, de résumé, de recherche ou de reporting sans relever à la main l’URL de chaque vidéo.

Conseils d’expert pour la YouTube Channel Videos API

  • La limite se multiplie avec le nombre d’entrées. Dix chaînes avec un results_limit de 100 demandent jusqu’à 1 000 enregistrements de vidéos classiques.
  • Lorsque vous intégrez un nouvel ensemble de chaînes, commencez avec une faible profondeur, vérifiez l’éligibilité, puis relevez la limite uniquement là où un historique plus long est utile.
  • Moins de résultats peut signifier que la chaîne compte moins de mises en ligne publiques éligibles. Cela n’indique pas automatiquement l’échec de la tâche.
  • Ne présentez pas la réponse comme une archive garantie complète : la disponibilité et le contenu public d’une chaîne peuvent évoluer.
  • Dédoublonnez sur l’ID de vidéo et conservez à la fois l’ID de la chaîne source et collected_at pour une analyse dans la durée.
  • Lancez les Shorts à part si le mélange des formats compte. Ne les combiner qu’après la collecte garde la classification explicite.
  • Utilisez Channels pour obtenir les champs de profil à jour plutôt que de recopier les bios et les compteurs de la chaîne sur chaque ligne de contenu.

En complément de la YouTube Channel Videos API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques YouTube.

  • 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 Channel Live Videos API — Collectez les diffusions publiques exposées sur les espaces live d’une chaîne, avec contexte source et indicateurs visibles.

Explorer d’autres plateformes

Combinez les données YouTube avec les données publiques d’autres plateformes sociales prises en charge.

YouTube Channel Videos API — FAQ

YouTube Channel Videos API collecte les vidéos publiques classiques d’une ou plusieurs URL de chaînes YouTube. Elle renvoie des titres, descriptions, informations de chaîne, miniatures, durées, dates de publication, indicateurs d’engagement et l’heure de collecte, le tout normalisé.

Envoyez une ou plusieurs URL de chaînes YouTube publiques et, si vous le souhaitez, un results_limit.

results_limit vaut 100 par défaut et s’applique séparément à chaque URL de chaîne. Le total final peut être plus bas lorsqu’une chaîne compte moins de vidéos classiques publiques éligibles.

Non. Cet endpoint renvoie les vidéos classiques d’une chaîne. Pour les Shorts d’une chaîne, utilisez Shorts.

Non. Les vues, les mentions « J’aime » et les commentaires sont des valeurs publiques observées au moment de la collecte. Il faut répéter les collectes pour construire des comparaisons historiques.

L’utilisation coûte 0,5 crédit pour chaque résultat de vidéo normalisé renvoyé.