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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL 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.
- 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.
- Envoyez le tableau urls en POST à /v1/youtube/videos et stockez le task_id renvoyé à côté de votre lot source.
- Interrogez /v1/tasks/{task_id} ; queued et running signifient que le lot est encore en cours de traitement.
- 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=50Cas 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.
API associées
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.
- YouTube Search API
- YouTube Channel Live Videos 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 Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API