YouTube Transcripts
Les transcriptions YouTube sont des versions en texte brut des sous-titres disponibles pour des vidéos publiques, avec la langue, la source des sous-titres, le contexte de la chaîne, les informations de publication et la durée. Ce texte sert l’accessibilité, la recherche, la vérification de citations, l’analyse thématique, le résumé et l’indexation de contenus.
Fonctionnalités de la YouTube Transcripts API
- Récupération de transcriptions sur plusieurs vidéosRécupérez en une seule requête le texte des transcriptions disponibles pour plusieurs URL de vidéos publiques.
- Choix de la langue préféréeDemandez une langue préférée avec un code BCP-47 valide, comme en ou zh-CN.
- Métadonnées de disponibilité des languesLa langue réellement retenue et la liste des langues de transcription disponibles sont renvoyées.
- Format de transcription en texte brutUn format texte brut homogène, accompagné de la source de la transcription lorsqu’elle est connue.
- Contexte vidéo traçableChaque transcription est reliée à l’ID de sa vidéo, son titre, les informations de sa chaîne, sa date de publication, sa durée et collected_at.
Paramètres de la YouTube Transcripts API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de vidéos YouTube publiques, séparées par des virgules ou des retours à la ligne. |
language | Facultatif | Langue de sous-titres BCP-47 préférée, facultative, comme en ou zh-CN ; la langue renvoyée peut différer. |
Comment utiliser la YouTube Transcripts API
Ne demandez les sous-titres qu’une fois choisies les vidéos qui comptent. Vérifiez ensuite la langue et la source renvoyées avant que le texte n’alimente la recherche, le RAG, le résumé, la traduction ou des workflows de conformité.
- Choisissez des URL de vidéos publiques, idéalement après qu’une phase de découverte ou de revue des métadonnées a écarté les éléments sans intérêt.
- Envoyez urls et, si vous le souhaitez, une language BCP-47 en POST à /v1/youtube/transcripts, puis stockez le task_id.
- Interrogez /v1/tasks/{task_id} ; un lot réussi peut tout de même contenir moins de résultats que d’URL envoyées.
- Pour chaque élément, inspectez language, available_languages et transcript_source avant de découper le texte brut ; paginez tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/transcripts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"],"language":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Cas d’usage de la YouTube Transcripts API
- Résumé de vidéos : Servez-vous du texte de transcription disponible pour rédiger des résumés, des notes de recherche ou des synthèses de contenu à partir de vidéos longues.
- Archives vidéo consultables : Indexez le texte des transcriptions avec les ID de vidéos, les titres, les informations de chaîne et les métadonnées de langue.
- Extraction de thèmes et d’informations : Repérez thèmes, entités, affirmations et mots-clés dans une sélection de vidéos publiques.
- Traduction et localisation : Appuyez-vous sur les champs de langue retenue et de langues disponibles pour orienter le texte des transcriptions vers des workflows de traduction.
Conseils d’expert pour la YouTube Transcripts API
- Aiguillez toujours selon la langue renvoyée, pas selon la préférence demandée. La solution de repli peut légitimement retenir une autre piste disponible.
- Les sous-titres générés automatiquement peuvent contenir des erreurs de noms, de ponctuation et de termes spécialisés. Conservez transcript_source et relisez les extraits sensibles en les confrontant à la vidéo.
- Une tâche réussie avec moins d’éléments signifie en général que certaines vidéos n’avaient aucun sous-titre public exploitable ; ce n’est pas automatiquement un échec du lot.
- Le texte brut ne comporte ni horodatage de segment ni étiquette de locuteur. N’en déduisez pas de minutage précis pour des citations.
- Découpez le texte en aval, mais gardez l’ID de vidéo, la langue, la source et collected_at sur chaque fragment pour que les citations restent traçables.
- Utilisez Videos pour enrichir le titre, le média et les indicateurs publics lorsque la transcription figurera dans un catalogue consultable.
- Si la couverture exacte d’une langue est impérative, comparez d’abord available_languages et traitez les résultats de repli comme des exceptions à revoir.
API associées
En complément de la YouTube Transcripts 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 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.
- 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