Clé API YouTube : comment l'obtenir et ce que le quota journalier paie
Une clé API YouTube demande quatre étapes dans la console Google Cloud : créer un projet, activer YouTube Data API v3, ouvrir Credentials, créer la clé. Elle ne lit que des données publiques. Publier une vidéo, lire tes propres analytics ou répondre à un commentaire demande OAuth 2.0, et c'est le quota journalier qui te limite vraiment.
Tout ce qui suit a été relevé dans la documentation YouTube Data API le 10 novembre 2026.
Comment obtenir une clé API YouTube
Il te faut un compte Google. La console est gratuite à ouvrir ; la YouTube Data API elle-même n'a pas de prix à l'appel, seulement un quota.
- Ouvre la console Google Cloud et crée un projet, ou sélectionne-en un que tu possèdes déjà.
- Ouvre l'API Library et active YouTube Data API v3. Si elle n'est pas activée, chaque requête répond 403 quelles que soient tes credentials.
- Ouvre la page Credentials.
- Sélectionne Create credentials > API key. La clé apparaît immédiatement.
- Sélectionne Restrict key avant de mettre quoi que ce soit en production.
Les mots de Google sur ce dernier point : « Restrict the key before using it in production. » Deux restrictions comptent. Une restriction d'API limite la clé à la YouTube Data API, donc une clé qui fuite ne peut pas être dépensée sur d'autres services Google. Une restriction d'application la limite aux adresses IP de ton serveur, à tes référents HTTP ou à la signature de ton app.
Une clé se passe dans la requête, en paramètre d'URL :
curl "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=VIDEO_ID&key=YOUR_API_KEY"
Ce qui veut dire qu'elle circule dans les URL, dans les logs serveur et dans l'historique du navigateur. Considère-la comme publique dès qu'elle est dans du code côté client, et garde tout ce qui te coûte du vrai quota derrière ton propre backend.
Clé API ou OAuth : les credentials YouTube dont tu as vraiment besoin
C'est là que la plupart des gens perdent un après-midi. La clé n'est pas un identifiant de connexion. Elle identifie ton projet pour la facturation et le quota, pas un utilisateur.
Google énonce la règle clairement : « Use an API key for requests that only retrieve public data, such as public video metadata or search results. » Pour tout le reste, ton application « must use the OAuth 2.0 protocol ».
| Ce que tu veux faire | Méthode | Credential |
|---|---|---|
| Lire les vues et le titre d'une vidéo publique | videos.list |
Clé d'API |
| Chercher des vidéos publiques | search.list |
Clé d'API |
| Lire le nombre d'abonnés d'une chaîne publique | channels.list |
Clé d'API |
| Publier une vidéo | videos.insert |
OAuth 2.0 |
| Modifier ou supprimer ta propre vidéo | videos.update, videos.delete |
OAuth 2.0 |
| Répondre à un commentaire | comments.insert |
OAuth 2.0 |
| Définir une miniature | thumbnails.set |
OAuth 2.0 |
Lire ta propre chaîne avec mine=true |
channels.list |
OAuth 2.0 |
Donc : si tu as cherché une clé API YouTube parce que tu veux un bot qui met tes vidéos en ligne, la clé n'est pas ce qu'il te faut. Il te faut un ID client OAuth, un écran de consentement, un refresh token et, dès que tu dépasses les utilisateurs de test, la revue de vérification de Google. L'ID client se crée sur la même page Credentials : Create credentials > OAuth client ID, puis choisis le type d'application.
La partie tokens de ce travail est la même sur tous les réseaux, et c'est elle qui continue de casser des mois plus tard. Les access tokens des réseaux sociaux couvre le refresh, l'expiration et les déconnexions silencieuses d'une plateforme à l'autre.
Ce que le quota journalier paie
YouTube ne compte pas les appels, il compte les unités. La documentation décrit l'allocation par défaut en trois pools :
- 100 appels
search.listpar jour. - 100 appels
videos.insertpar jour. - 10 000 unités par jour pour tous les autres endpoints.
Les coûts en unités qui comptent, directement depuis le tableau de quota :
| Méthode | Coût en unités | Ce que ça fait |
|---|---|---|
videos.list |
1 | Lire les métadonnées et les statistiques d'une vidéo |
channels.list |
1 | Lire les données d'une chaîne |
playlists.list |
1 | Lire les playlists |
commentThreads.list |
1 | Lire les commentaires de premier niveau |
comments.list |
1 | Lire les réponses |
playlistItems.insert |
50 | Ajouter une vidéo à une playlist |
comments.insert |
50 | Publier un commentaire ou une réponse |
thumbnails.set |
50 | Définir une miniature personnalisée |
captions.insert |
400 | Envoyer une piste de sous-titres |
Les lectures coûtent peu, les écritures non. Un upload de sous-titres coûte 400 unités, donc 25 suffisent à épuiser le pool principal à eux seuls. Et chaque requête compte, y compris celles qui échouent : une requête invalide coûte au moins une unité, donc une boucle de retry sur un mauvais paramètre brûle du quota aussi vite que du vrai travail.
Les chiffres de quota qui surprennent
Trois choses piègent les équipes.
La recherche a son propre pool, et il est petit. Cent appels search.list par jour, ce n'est rien pour une fonction de recherche. Si tu construis une recherche sur YouTube, tu mets les résultats en cache ou tu demandes plus de quota via le formulaire d'extension. Paginer coûte un appel par page, donc un utilisateur qui fait défiler quatre pages dépense quatre de tes cent appels.
Les uploads sont plafonnés en nombre, pas en unités. Cent appels videos.insert par jour paraît généreux jusqu'à ce que tu gères plusieurs chaînes. Le plafond est par projet, pas par chaîne, donc dix chaînes se partagent les mêmes cent appels.
Le quota se remet à zéro à l'heure du Pacifique, pas à la tienne. Le compteur journalier bascule à minuit heure du Pacifique. Si ton scheduler se déclenche à minuit à Paris, tu dépenses le quota de la veille.
Quand il t'en faut plus, la page Quotas de la console montre la consommation et Google fournit un formulaire de demande d'extension. Prépare-toi à décrire ton cas d'usage et à attendre. La documentation prévient aussi que l'allocation par défaut est « subject to change », une bonne raison de logger ta consommation d'unités plutôt que de supposer que les chiffres d'aujourd'hui tiendront toujours.
Publier sur YouTube et sur sept autres réseaux
Si YouTube est la seule plateforme que tu touches, construis-le toi-même : un client OAuth, un refresh token, terminé. Le calcul change quand YouTube n'est qu'un réseau parmi plusieurs, parce que chaque plateforme a son propre flux OAuth, sa propre revue et son propre modèle de quota. Le guide des API réseaux sociaux met ces différences côte à côte, et l'API analytics réseaux sociaux explique pourquoi la même métrique se lit différemment selon le réseau.
C'est le manque que PlugKit comble. Il connecte Instagram, Facebook, LinkedIn, TikTok, YouTube, X, WhatsApp et Telegram derrière une seule API REST et un seul serveur MCP hébergé à https://api.plugkit.co/mcp, gère l'OAuth et le refresh des tokens, et coûte 49 $ par mois pour 5 comptes connectés, résiliable à tout moment. Sept jours gratuits, carte demandée à l'inscription et rien de prélevé avant le 7e jour.
Cela n'enlève pas le quota YouTube, et rien ne le peut : le quota appartient à celui qui possède le projet d'API. Ce que cela enlève, c'est le travail de credentials par plateforme. Si tu n'avais besoin que des métadonnées publiques des vidéos, une simple clé API et 30 lignes de code restent la bonne réponse, et c'est celle qu'il faut prendre.
FAQ
Est-ce que la clé API YouTube est gratuite ?
Oui. La YouTube Data API n'a pas de prix à l'appel. Ce que tu as à la place, c'est un quota journalier, par défaut 10 000 unités pour les endpoints généraux plus des pools séparés de 100 appels de recherche et 100 uploads. Aller au-delà veut dire demander une extension, pas payer une facture.
Est-ce que je peux publier une vidéo avec juste une clé API YouTube ?
Non. Les uploads passent par videos.insert, et Google exige OAuth 2.0 pour chaque insertion, mise à jour et suppression. La clé API identifie ton projet, elle n'autorise pas une action sur une chaîne. Il te faut un ID client OAuth, le consentement de l'utilisateur et un refresh token.
Comment obtenir une clé API YouTube gratuitement ?
Crée un projet Google Cloud, active YouTube Data API v3 dans l'API Library, ouvre Credentials puis choisis Create credentials, et API key. Aucune carte n'est demandée pour le quota de la Data API. Restreins la clé à la YouTube Data API avant de la mettre en production.
Qu'est-ce qui se passe quand j'atteins le quota de l'API YouTube ?
Les requêtes répondent 403 avec le motif quotaExceeded jusqu'à la remise à zéro du compteur, à minuit heure du Pacifique. Rien n'est facturé et rien n'est ralenti progressivement : tu t'arrêtes, simplement, jusqu'à la remise à zéro, et c'est pour ça que grouper les lectures et mettre les recherches en cache compte plus que d'optimiser les appels un par un.
Quelle est la différence entre une clé API YouTube et des credentials OAuth ?
Une clé identifie ton projet et ne lit que des données publiques. Les credentials OAuth identifient un utilisateur qui a donné accès à ton app, et c'est ce qui te permet de publier, modifier, commenter ou lire des données privées de chaîne. Beaucoup de projets ont besoin des deux : la clé pour les lectures publiques, OAuth pour tout ce qui touche à la chaîne de l'utilisateur.
Un plug pour chaque plateforme que ton agent touche
49 $ par mois pour 5 comptes connectés, résiliable à tout moment. Toutes les fonctionnalités dans tous les forfaits.
Récupère ta clé API →