youtube/
transcripts

Récupérez les transcriptions disponibles à partir d’URL de vidéos YouTube, avec une langue facultative, et obtenez texte normalisé, langue et source des sous-titres, contexte de la chaîne et durée.

YouTube Transcripts API

Transcriptions
Texte brut
Langue préférée
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 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ètresObligatoireDescription
urlsObligatoireURL de vidéos YouTube publiques, séparées par des virgules ou des retours à la ligne.
languageFacultatifLangue 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é.

  1. 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.
  2. Envoyez urls et, si vous le souhaitez, une language BCP-47 en POST à /v1/youtube/transcripts, puis stockez le task_id.
  3. Interrogez /v1/tasks/{task_id} ; un lot réussi peut tout de même contenir moins de résultats que d’URL envoyées.
  4. 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=50

Cas 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.

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.

Explorer d’autres plateformes

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

YouTube Transcripts API — FAQ

YouTube Transcripts API récupère le texte des sous-titres disponibles à partir d’URL de vidéos YouTube publiques, avec une langue préférée facultative. Elle renvoie du texte brut normalisé, les langues réelle et disponibles, la source des sous-titres, le contexte de la vidéo, la durée et l’heure de collecte.

Envoyez une ou plusieurs URL de vidéos YouTube publiques et, si vous le souhaitez, une langue préférée au format BCP-47.

Vous pouvez demander une langue préférée. Si aucune correspondance exacte n’existe, l’API peut retenir la langue de base ou une autre transcription disponible. Lisez toujours le champ language renvoyé.

Une vidéo sans sous-titres publics ni texte de transcription disponible ne produit aucun résultat de transcription.

Non. La réponse est au format texte brut et ne comprend ni horodatage de segment ni étiquette de locuteur garantie.

Non. L’exactitude dépend de l’origine des sous-titres, fournis par le créateur ou générés automatiquement, ainsi que de la qualité audio, de la langue et des locuteurs.

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