Appelez l'API YouTube Data v3 avec curl + jq. Le jeton OAuth de l'utilisateur se trouve dans $GOOGLE_YOUTUBE_TOKEN ; chaque appel nécessite Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN. URL de base : https://www.googleapis.com/youtube/v3.
Le jeton contient toujours les portées youtube.readonly ainsi que les portées d'identité (openid email profile) ; si l'utilisateur a opté pour lors de l'installation, il contient également youtube.upload (publier des vidéos).
Les réponses sont au format JSON standard ; les échecs se présentent comme {"error": {"code": 401|403|..., "message": "..."}} — affichez cette erreur textuellement. 401 → jeton expiré, l'utilisateur doit reconnecter le connecteur YouTube. 403 insufficientPermissions lors d'un téléversement → l'utilisateur n'a pas accordé youtube.upload ; demandez-lui de se reconnecter avec la case de téléchargement cochée.
Commencez toujours par la vérification de la chaîne pour confirmer que la connexion fonctionne et savoir à quelle chaîne vous avez affaire.
curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
"https://www.googleapis.com/youtube/v3/channels?part=snippet,statistics,contentDetails&mine=true" \
| jq '.items[0] | {title: .snippet.title, subs: .statistics.subscriberCount, views: .statistics.viewCount, uploads: .contentDetails.relatedPlaylists.uploads}'
Recherche YouTube
# Recherche publique (n'importe quelle vidéo). type peut être video|channel|playlist.
curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
--data-urlencode "q=ai video automation" \
--data-urlencode "part=snippet" \
--data-urlencode "type=video" \
--data-urlencode "maxResults=10" \
-G "https://www.googleapis.com/youtube/v3/search" \
| jq '.items[] | {videoId: .id.videoId, title: .snippet.title, channel: .snippet.channelTitle, published: .snippet.publishedAt}'
Ajoutez --data-urlencode "order=date|viewCount|rating|relevance" pour trier, ou --data-urlencode "publishedAfter=2026-01-01T00:00:00Z" pour filtrer par date.
Voir mes vidéos téléversées
YouTube n'a pas d'appel direct "lister mes vidéos" — lisez la playlist de téléversements de la chaîne, puis parcourez ses éléments.
# 1. Obtenez l'identifiant de la playlist de téléversements (UU...) — identique à l'appel des chaînes ci-dessus.
UPLOADS=$(curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
"https://www.googleapis.com/youtube/v3/channels?part=contentDetails&mine=true" \
| jq -r '.items[0].contentDetails.relatedPlaylists.uploads')
# 2. Listez les téléversements récents (50/page ; suivez .nextPageToken pour plus).
curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
-G "https://www.googleapis.com/youtube/v3/playlistItems" \
--data-urlencode "part=snippet,contentDetails" \
--data-urlencode "playlistId=$UPLOADS" \
--data-urlencode "maxResults=50" \
| jq '.items[] | {videoId: .contentDetails.videoId, title: .snippet.title, published: .snippet.publishedAt}'
Paginez en passant --data-urlencode "pageToken=$PAGE_TOKEN" avec le .nextPageToken de la réponse précédente.
Statistiques des vidéos (vues / likes / commentaires)
# Accepte une liste d'identifiants séparés par des virgules.
curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
-G "https://www.googleapis.com/youtube/v3/videos" \
--data-urlencode "part=snippet,statistics,status" \
--data-urlencode "id=VIDEO_ID_1,VIDEO_ID_2" \
| jq '.items[] | {title: .snippet.title, views: .statistics.viewCount, likes: .statistics.likeCount, comments: .statistics.commentCount, privacy: .status.privacyStatus}'
Lire les commentaires d'une vidéo
curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
-G "https://www.googleapis.com/youtube/v3/commentThreads" \
--data-urlencode "part=snippet" \
--data-urlencode "videoId=VIDEO_ID" \
--data-urlencode "maxResults=20" \
--data-urlencode "order=relevance" \
| jq '.items[] | .snippet.topLevelComment.snippet | {author: .authorDisplayName, text: .textDisplay, likes: .likeCount}'
Téléverser une vidéo (nécessite youtube.upload)
Confirmez avec l'utilisateur avant de publier — affichez le titre, la confidentialité et le fichier que vous êtes sur le point de téléverser. Les téléversements sont un flux reprise en deux étapes : initialisation avec les métadonnées → PUT des octets.
FILE="/chemin/vers/video.mp4"
TITLE="Mon titre"
DESC="Ma description"
# privacyStatus: public | unlisted | private
read -r -d '' META <<JSON
{"snippet":{"title":"$TITLE","description":"$DESC","categoryId":"22"},
"status":{"privacyStatus":"unlisted","selfDeclaredMadeForKids":false}}
JSON
# 1. Initialisez la session de reprise -> capturez l'URL de téléversement depuis l'en-tête Location.
UPLOAD_URL=$(curl -sS -D - -o /dev/null \
-H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
-H "Content-Type: application/json; charset=UTF-8" \
-H "X-Upload-Content-Type: video/*" \
-X POST "https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status" \
-d "$META" | tr -d '\r' | awk '/^[Ll]ocation:/{print $2}')
# 2. Téléversez les octets -> retourne la ressource vidéo créée (contient .id).
curl -sS -H "Authorization: Bearer $GOOGLE_YOUTUBE_TOKEN" \
-H "Content-Type: video/*" \
-X PUT --upload-file "$FILE" "$UPLOAD_URL" \
| jq '{id: .id, url: ("https://www.youtube.com/watch?v=" + .id), privacy: .status.privacyStatus}'
categoryId 22 = "People & Blogs" (une valeur par défaut sûre). Pour définir une vignette personnalisée (nécessite que le fichier soit d'abord traité), appelez POST /upload/youtube/v3/thumbnails/set?videoId=VIDEO_ID avec l'image.
Pièges à éviter
- Quota : l'API Data est limitée par quota (10 000 unités/jour par défaut). Une
searchcoûte 100 unités ; unuploadcoûte ~1 600 unités. Une rafale de recherches peut épuiser le quota quotidien →403 quotaExceeded; affichez-le clairement. - Pas de point de terminaison "mes vidéos" — passez toujours par la playlist de téléversements.
- Les résultats de
searchsont éventuellement cohérents — une vidéo fraîchement téléversée peut ne pas apparaître danssearchpendant plusieurs minutes/heures ; lisez-la via la playlist de téléversements ou par son identifiant à la place. - Les vidéos téléversées commencent dans l'état
uploaded/processing; les statistiques sont à0jusqu'à la fin du traitement.