Python · YouTube
Scraper YouTube avec Python
Scraper YouTube avec un navigateur, c'est faire défiler des listes infinies, attendre des scripts et parser un balisage qui change souvent. La YouTube Data API officielle exige un projet Google Cloud et rationne les requêtes avec un quota journalier. Ce guide prend une troisième voie : vous scrapez YouTube avec Python en appelant l'API everydata.io, qui lit les pages YouTube publiques et les renvoie en JSON.
Vous construisez trois petits scripts : un scraper YouTube pour les résultats de recherche, qui parcourt les pages de résultats et les enregistre en CSV, un deuxième qui liste les dernières vidéos d'une chaîne, et un troisième qui récupère tous les détails d'une vidéo – vues, likes, nombre de commentaires, date de publication, durée, catégorie et tags.
Mis à jour le · par everydata.io
Ce que vous aurez à la fin
- Un script Python qui scrape les résultats de recherche YouTube pour n'importe quel terme de recherche dans videos.csv.
- Les dernières vidéos de n'importe quelle chaîne, par ID de chaîne, URL de handle ou URL de chaîne.
- Les détails complets d'une vidéo par ID, avec une fonction utilitaire réutilisable qui gère les limites de débit et les nouvelles tentatives.
Ce dont vous avez besoin
- Python 3.10 ou plus récent et le paquet
requests(pip install requests). - Une clé API everydata.io gratuite – créez-la ici.
- Un terme de recherche, une chaîne ou une vidéo à scraper.
01Pourquoi scraper YouTube via une API ?
YouTube construit ses pages en JavaScript et charge d'autres résultats à mesure que vous faites défiler : une simple requête HTTP ne récupère donc que peu de données exploitables, et un navigateur headless doit faire défiler, attendre et parser. L'API YouTube d'everydata.io fait ce travail côté serveur : chaque appel renvoie une page de résultats, avec un cursor pour la suivante.
Par rapport à la YouTube Data API officielle, pas d'écran OAuth, pas de projet Google Cloud et pas de quota journalier en unités – seulement votre clé everydata.io. Chaque appel compte pour une requête de votre offre, et les réponses avec un statut 5xx ne sont pas décomptées.
02Écrivez une petite fonction utilitaire pour les requêtes
Placez votre clé dans l'environnement (export EVERYDATA_API_KEY="ds_your_key") et enregistrez cette fonction sous everydata.py. Elle attend lorsque vous envoyez trop de requêtes à la fois (statut 429, la réponse indique combien de secondes) et relance une fois le chargement d'une page qui a échoué (5xx).
import os
import re
import time
import requests
API = "https://api.everydata.io"
KEY = os.environ["EVERYDATA_API_KEY"]
def api_get(path: str, params: dict) -> dict:
"""GET an everydata.io endpoint. Waits when rate limited (429) and retries a failed page load (5xx) once."""
retried = False
for _ in range(4):
resp = requests.get(f"{API}{path}", params=params, headers={"x-api-key": KEY}, timeout=60)
if resp.status_code == 429:
wait = re.search(r"in (\d+) seconds", resp.text)
time.sleep(int(wait.group(1)) + 1 if wait else 60)
continue
if resp.status_code >= 500 and not retried:
retried = True # 5xx answers are not counted against your quota
time.sleep(10)
continue
resp.raise_for_status()
return resp.json()
raise RuntimeError("still rate limited after several waits – try again later")03Scrapez les résultats de recherche YouTube dans un fichier CSV
L'endpoint de recherche prend une query ainsi que languageCode et countryCode facultatifs (par défaut en et US), et renvoie la liste des résultats dans items ainsi qu'un cursor pour la page suivante. Les résultats mélangent vidéos, chaînes et playlists : le script ne garde donc que type video.
"""Scrape YouTube search results for a query into videos.csv – several pages via the cursor."""
import csv
from everydata import api_get # the helper from step 2, saved as everydata.py
QUERY = "lofi hip hop"
MAX_PAGES = 3 # every page is one request
rows, cursor = [], None
for page in range(1, MAX_PAGES + 1):
params = {"query": QUERY, "languageCode": "en", "countryCode": "US"}
if cursor:
params["cursor"] = cursor
data = api_get("/ytb/youtube-search-videos", params)
for item in data["items"]:
if item["type"] != "video": # results also contain channels and playlists
continue
rows.append({
"page": page,
"video_id": item["videoId"],
"title": item["title"],
"channel": item["channelName"],
"views": item["viewCount"],
"published": item["publishedTimeText"],
"duration_s": item["duration"],
"live": item["isLive"],
})
cursor = data.get("cursor")
if not cursor:
break
with open("videos.csv", "w", newline="") as f:
writer = csv.DictWriter(f, fieldnames=list(rows[0]))
writer.writeheader()
writer.writerows(rows)
print(len(rows), "videos saved to videos.csv")Une version abrégée de l'exemple documenté pour la recherche lofi hip hop :
{
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"query": "lofi hip hop",
"estimatedResults": 2407972,
"items": [
{
"type": "video",
"videoId": "n61ULEU7CO0",
"title": "Best of lofi hip hop 2021 ✨ [beats to relax/study to]",
"channelId": "UCSJ4gkVC6NrvII8umztf0Ow",
"channelName": "Lofi Girl",
"viewCount": 57439529,
"viewCountText": "57,439,529 views",
"publishedTimeText": "4 years ago",
"duration": 22258,
"durationText": "6:10:58",
"isLive": false
}
]
}viewCount est un nombre que vous pouvez trier et additionner ; viewCountText est le libellé affiché par YouTube. Pour les diffusions en direct, le libellé indique « watching » et duration vaut null. Dans les résultats de recherche, publishedTimeText est relatif (« 4 years ago ») – l'appel de détails vidéo renvoie la valeur exacte publishedAt.
04Scrapez les vidéos d'une chaîne YouTube
Pour une chaîne, passez son ID de chaîne, son URL de handle (https://www.youtube.com/@WWE) ou son URL de chaîne dans id. filter choisit l'onglet : videos_latest (par défaut), streams_latest, shorts_latest ou live_now. Passez aux pages suivantes avec cursor, comme dans le script de recherche.
from everydata import api_get
data = api_get("/ytb/youtube-channel-videos", {"id": "https://www.youtube.com/@WWE", "filter": "videos_latest"})
for item in data["items"]:
print(item["videoId"], item["viewCount"], item["publishedTimeText"], item["title"])
next_page = data["cursor"] # pass as cursor=... for the next page{
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"channelId": "UCJ5v_MCY6GNUBTO8-D3XoAg",
"filter": "videos_latest",
"items": [
{
"type": "video",
"videoId": "b7kl_pcHa0A",
"title": "Blake Monroe vows to get payback against Giulia: SmackDown exclusive, Sept. 18, 2026",
"viewCount": 6800,
"viewCountText": "6.8K views",
"publishedTimeText": "47 minutes ago",
"duration": 110,
"durationText": "1:50"
}
]
}05Scrapez les détails d'une vidéo YouTube
Les listes de recherche et de chaîne vous donnent des ID de vidéo. Pour la fiche complète d'une vidéo – nombres exacts de vues, de likes et de commentaires, date de publication, catégorie, tags et plus encore – appelez l'endpoint de détails vidéo avec l'ID ou l'URL de la vidéo.
from everydata import api_get
v = api_get("/ytb/youtube-video-details", {"id": "kJQP7kiw5Fk"})
print(v["title"], "by", v["channelName"])
print(v["viewCount"], "views,", v["likeCount"], "likes,", v["commentCount"], "comments")
print("published", v["publishedAt"], "| duration", v["durationText"], "| category", v["category"])
print("tags:", ", ".join(v["tags"])){
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"videoId": "kJQP7kiw5Fk",
"title": "Luis Fonsi - Despacito ft. Daddy Yankee",
"channelName": "LuisFonsiVEVO",
"viewCount": 9125159593,
"likeCount": 56673581,
"commentCount": 4300000,
"publishedAt": "2017-01-12T21:00:02-08:00",
"duration": 282,
"durationText": "4:42",
"category": "Music",
"tags": [
"Calypso",
"Despacito"
]
}Pour suivre ces chiffres dans le temps, le guide sur les statistiques de vidéos YouTube les enregistre à intervalles réguliers. Pour la section commentaires d'une vidéo, consultez l'API de commentaires YouTube.
06Coûts et limites du scraping de YouTube
- Chaque page de recherche, page de chaîne et consultation de vidéo compte pour une requête. Trois pages de recherche plus les détails de 20 vidéos font 23 requêtes ; l'offre gratuite inclut 100 requêtes par mois.
- Les résultats suivent
languageCodeetcountryCode, comme YouTube le fait pour un visiteur de ce pays. - Uniquement des données publiques : les vidéos privées, supprimées ou bloquées dans la région renvoient un HTTP 404 au lieu d'un objet à moitié rempli.
Endpoints utilisés dans ce guide
Search Videos · API YouTube
Channel Videos · API YouTube
Video Details · API YouTube
Ce que vous pouvez faire d’autre avec ces données
Métadonnées YouTube en JSON – titre, vues, likes, commentaires, durée, tags, miniatures, sous-titres – par ID ou URL. Sans OAuth ni quota Data API.
Statistiques publiques de chaînes YouTube en REST : abonnés, nombre de vidéos, vérification, dernières vidéos, lives, Shorts et playlists par ID ou @handle.
Scrapez les commentaires YouTube par ID ou URL : texte, auteur, likes, réponses, épinglé et cœur, pagination par curseur dans les réponses. Sans OAuth.
Essayez avec vos propres données
L’offre gratuite comprend 100 requêtes par mois, utilisables sur toutes les plateformes – de quoi suivre ce guide de bout en bout.