Documentation API

Une API REST pour les transcriptions YouTube, la recherche et les métadonnées. Obtenez une clé API depuis votre tableau de bord — 100 crédits gratuits, sans carte requise.

Authentification

Transmettez votre clé API comme jeton porteur (bearer token), ou via x-api-key :

Authorization: Bearer sk_live_...
# or
x-api-key: sk_live_...

URL de base

https://getyoutubetranscript.com/api/v1

Crédits et offres

Offre	Prix	Crédits/mois	Prix du complément	Limite de débit
Gratuit	0 $	100 (unique)	—	60 req/min
Mensuel	5,00 $/mois	1 000	2,50 $ / 1 000	200 req/min
Annuel	4,50 $/mois (54 $/an)	1 000	1,50 $ / 1 000	300 req/min

1 crédit = 1 requête réussie. Les requêtes échouées ne sont jamais facturées. Les crédits complémentaires expirent 30 jours après l'achat ou à la fin de votre période de facturation en cours, selon la date la plus tardive, et nécessitent un abonnement actif pour être dépensés.

Points d'accès

GET/transcript1 crédit

Récupère la transcription d'une vidéo YouTube, avec ses métadonnées (titre, chaîne, miniature).

Paramètre	Obligatoire	Description
`v`	Oui	ID de la vidéo ou URL YouTube complète
`language`	Non	Code de langue (par défaut : en)

Requête

curl "https://getyoutubetranscript.com/api/v1/transcript?v=jNQXAC9IVRw" \
  -H "Authorization: Bearer sk_live_..."

Réponse

{
  "success": true,
  "data": {
    "video_id": "jNQXAC9IVRw",
    "language_code": "en",
    "title": "Me at the zoo",
    "author_name": "jawed",
    "author_url": "https://www.youtube.com/channel/UC4Qob...",
    "thumbnail_url": "https://...",
    "transcript": "All right, so here we are...",
    "word_count": 39
  }
}

GET/search1 crédit / page

Recherche des vidéos YouTube avec filtres et pagination.

Paramètre	Obligatoire	Description
`q`	Oui	Requête de recherche (2 caractères minimum)
`country`	Non	Code pays à 2 lettres (par défaut : us)
`language`	Non	Code de langue (par défaut : en)
`page_token`	Non	Le pagination.next_page_token de la réponse précédente, pour récupérer la page suivante
`limit`	Non	Nombre maximal de résultats (par défaut 20, max 50)

Requête

curl "https://getyoutubetranscript.com/api/v1/search?q=lofi+beats" \
  -H "Authorization: Bearer sk_live_..."

Réponse

{
  "success": true,
  "data": {
    "query": "lofi beats",
    "video_results": [ { "title": "...", "videoId": "...", "channel": { "name": "..." } } ],
    "pagination": { "next_page_token": "..." }
  }
}

GET/resolveGratuit

Résout un handle, une URL ou un nom d'utilisateur de chaîne vers son véritable ID de chaîne. Une entrée déjà syntaxique (déjà un ID de chaîne ou une URL en contenant un) est résolue instantanément sans appel réseau ; un simple handle déclenche une véritable recherche.

Paramètre	Obligatoire	Description
`handle`	Oui	ID de chaîne, URL ou @handle

Requête

curl "https://getyoutubetranscript.com/api/v1/resolve?handle=@mkbhd" \
  -H "Authorization: Bearer sk_live_..."

Réponse

{
  "success": true,
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "title": "Marques Brownlee",
    "handle": "http://www.youtube.com/@mkbhd",
    "resolved_via": "scrape"
  }
}

GET/playlist1 crédit / page

Récupère les vidéos d'une playlist. Ne renvoie actuellement que la première page - has_more indique s'il y a d'autres vidéos, mais la récupération de pages supplémentaires n'est pas encore prise en charge.

Paramètre	Obligatoire	Description
`list`	Oui	ID ou URL de la playlist

Requête

curl "https://getyoutubetranscript.com/api/v1/playlist?list=PLxxx" \
  -H "Authorization: Bearer sk_live_..."

Réponse

{
  "success": true,
  "data": {
    "playlist_id": "PLxxx",
    "title": "...",
    "videos": [ { "position": 1, "id": "...", "title": "...", "channel": { "name": "..." } } ],
    "has_more": true
  }
}

Erreurs

Les erreurs renvoient un corps JSON avec un champ code stable pour vos branchements conditionnels, en plus du statut HTTP :

Statut	Code	Signification
400	`BAD_REQUEST`	Paramètre manquant ou invalide
401	`MISSING_API_KEY / INVALID_API_KEY`	Aucune clé fournie, ou clé invalide/révoquée
402	`PAYMENT_REQUIRED`	Plus de crédits - achetez un complément ou passez à une offre supérieure
404	`VIDEO_UNAVAILABLE / TRANSCRIPT_NOT_FOUND`	Vidéo ou ressource introuvable
429	`RATE_LIMITED`	Trop de requêtes pour votre offre
503	`UPSTREAM_UNAVAILABLE`	Problème temporaire en amont - nouvelle tentative sans risque

Bientôt disponible

La recherche au sein d'une chaîne, la liste de toutes les vidéos d'une chaîne, et la pagination complète des playlists sont en développement. Le suivi des nouvelles publications via RSS est temporairement indisponible en raison d'un problème indépendant côté YouTube.

Utiliser cette API avec un outil IA

Vous préférez laisser Claude (ou un autre outil IA de codage) appeler cette API à votre place plutôt que d'écrire les requêtes à la main ? Téléchargez le skill YouTube Transcript - un Claude Skill prêt à l'emploi qui lui apprend à récupérer des transcriptions, effectuer des recherches, et plus encore.