youtube/
videos

Récupérez les métadonnées publiques de vidéos ou de Shorts YouTube dont vous connaissez l’URL, avec titres, contexte de la chaîne, miniatures, durée et engagement visible, le tout normalisé.

YouTube Videos API

Détails de vidéo
URL connues
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 Videos

Les vidéos YouTube publiques sont des mises en ligne accompagnées de titres, de descriptions, du contexte de la chaîne, de miniatures, de la durée, d’informations de publication, de hashtags, d’une classification de la source et d’un engagement visible. Ces signaux de métadonnées et de performance servent à enrichir des vidéos, à mener des recherches de contenu, à surveiller et à comparer.

Fonctionnalités de la YouTube Videos API

  • Consultation par lot d’URL connuesInterrogez en une seule requête plusieurs URL connues de vidéos et de Shorts publics.
  • Identité de vidéo stableUn ID de vidéo stable, l’URL canonique, le titre, la description publique et la chaîne qui publie sont renvoyés pour chaque résultat.
  • Métadonnées de contenuMiniatures, durée, hashtags, date de publication et type de contenu normalisé sont inclus.
  • Indicateurs d’engagement ponctuelsCapturez les nombres publics de vues, de mentions « J’aime » et de commentaires avec collected_at, pour comparer des instantanés.
  • Schéma vidéo homogèneUne même structure vidéo normalisée pour les vidéos classiques et pour les URL de Shorts prises en charge.

Paramètres de la YouTube Videos API

ParamètresObligatoireDescription
urlsObligatoireURL de vidéos ou de Shorts YouTube publics, séparées par des virgules ou des retours à la ligne.

Comment utiliser la YouTube Videos API

Transformez une boîte de liens en enregistrements que votre application peut relier, rechercher et actualiser. La requête est asynchrone : gardez l’ID de tâche jusqu’à ce que chaque URL accessible ait été résolue.

  1. Rassemblez et dédoublonnez des URL publiques de lecture ou de Shorts ; les URL de chaînes et de résultats de recherche relèvent d’autres endpoints.
  2. Envoyez le tableau urls en POST à /v1/youtube/videos et stockez le task_id renvoyé à côté de votre lot source.
  3. Interrogez /v1/tasks/{task_id} ; queued et running signifient que le lot est encore en cours de traitement.
  4. En cas de réussite, indexez data.results.items par id et poursuivez avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"]}'

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

Cas d’usage de la YouTube Videos API

  • Enrichissement d’une liste d’URL : Ajoutez titres, informations de chaîne, miniatures, durée, dates de publication et indicateurs publics à une liste existante d’URL YouTube.
  • Comparaison de vidéos sélectionnées : Comparez vues, mentions « J’aime », commentaires, durée et informations de publication d’un ensemble choisi de vidéos ou de Shorts.
  • Veille sur les campagnes et les concurrents : Collectez des instantanés de métadonnées répétés pour des vidéos de campagnes, de créateurs ou de concurrents que vous connaissez.
  • Catalogues de contenus : Fournissez des enregistrements vidéo normalisés à vos workflows internes de recherche, de reporting, de modération, de résumé ou d’analytique.

Conseils d’expert pour la YouTube Videos API

  • Faites de id votre clé primaire. Les titres peuvent changer, et une même vidéo peut arriver par plusieurs formats d’URL valides.
  • Gardez canonical_url pour les liens sortants, mais conservez input_url quand vous devez retrouver l’origine d’un enregistrement.
  • Les indicateurs décrivent la page à l’instant collected_at. Comparer deux instantanés est utile ; écraser l’ancien efface cet historique.
  • Traitez les liens de la description comme une entrée externe non fiable avant de les afficher, de les explorer ou de les importer.
  • Un résultat absent ne prouve pas qu’une URL n’a jamais existé. Les éléments privés, supprimés, restreints ou temporairement inaccessibles peuvent disparaître d’un lot.
  • Les commentaires et le texte des transcriptions sont volontairement à part. Ne les demandez que pour les éléments qui atteignent ces étapes dans votre workflow.
  • Pour découvrir des vidéos par sujet, commencez par Search. Réservez Videos aux cas où vous savez déjà quelle URL compte.

En complément de la YouTube 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 Shorts API — Collectez par chaîne les Shorts publics, miniatures, durée, informations de publication et l’engagement.
  • YouTube Related Videos API — Listez les vidéos recommandées à côté d’une URL de vidéo, avec titres, chaînes, vues et miniatures.

Explorer d’autres plateformes

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

YouTube Videos API — FAQ

YouTube Videos API récupère les métadonnées publiques d’URL connues de vidéos ou de Shorts YouTube. Elle renvoie l’identité, les titres, les descriptions, les informations de chaîne, les miniatures, la durée, les dates de publication, les indicateurs d’engagement et l’heure de collecte, le tout normalisé.

Envoyez dans le tableau urls une ou plusieurs URL de vidéos ou de Shorts YouTube publics.

Oui. Les URL de Shorts publics sont prises en charge et suivent la même structure vidéo normalisée, avec leur type de contenu conservé.

Non. Ces indicateurs sont des valeurs publiques observées au moment de la collecte. Stockez collected_at et collectez de nouveau les mêmes URL lorsque vous avez besoin de comparaisons historiques.

Le résultat d’une vidéo contient le nombre public de commentaires, pas leur texte ni celui de la transcription. Utilisez Comments pour les commentaires et Transcripts pour les sous-titres disponibles.

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