Lorsque votre workflow part d’un créateur plutôt que de l’URL d’une vidéo, récupérez d’abord la chaîne et ses vidéos récentes. Vous obtenez une liste limitée d’ID à utiliser pour demander ensuite des métadonnées ou des sous-titres. Ce tutoriel enregistre un instantané de la chaîne et un fichier d’ID avec la bibliothèque standard de Python.
Ce que renvoie l’endpoint Channel
Avec youtube_channel, vous pouvez utiliser un identifiant de chaîne tel que @jawed ; le préfixe @ est facultatif. params.video_limit définit le nombre de vidéos récentes à demander, de 1 à 100, avec une valeur par défaut de 20. Le nombre de vidéos disponibles peut être inférieur.
Le champ renvoyé videoCount indique le nombre total de vidéos de la chaîne. Le tableau videos contient les vidéos récentes renvoyées par cette requête. Demander 20 vidéos ne récupère pas l’ensemble des archives de la chaîne. Cet endpoint ne propose pas de paramètre de pagination documenté pour parcourir toutes les vidéos historiques.
Les statistiques et les images de la chaîne peuvent être absentes ou null. Préservez cette distinction : un nombre d’abonnés indisponible ne signifie pas que la chaîne n’a aucun abonné.
Définir l’identifiant de chaîne et limiter la collecte
Créez une clé API associée à un compte disposant de crédits. Commencez avec une petite limite pour examiner la réponse avant de prévoir un workflow plus vaste. Récupérer la chaîne, puis les métadonnées de chaque vidéo, correspond à des requêtes API distinctes.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
Enregistrer l’instantané de la chaîne et les ID vidéo
Enregistrez ce code dans channel-videos.py. Le script vérifie que le traitement est terminé, extrait les ID vidéo valides et conserve les données vidéo d’origine en JSON. Chaque ID unique est écrit une seule fois, même si la réponse contient des doublons.
import json
import os
import re
from pathlib import Path
from urllib.request import Request, urlopen
from urllib.error import HTTPError
key = os.environ["FLASHDATA_API_KEY"]
handle = os.environ.get("YOUTUBE_HANDLE", "@jawed").strip()
limit = int(os.environ.get("VIDEO_LIMIT", "20"))
if not handle or len(handle) > 100:
raise ValueError("Use a channel handle of at most 100 characters")
if not 1 <= limit <= 100:
raise ValueError("VIDEO_LIMIT must be between 1 and 100")
request = Request(
"https://data.flashdata.dev/v1/queries/realtime",
data=json.dumps({"source": "youtube_channel", "handle": handle,
"params": {"video_limit": limit}}).encode(),
method="POST", headers={"Content-Type": "application/json", "X-API-Key": key},
)
try:
with urlopen(request, timeout=60) as response:
payload = json.load(response)
except HTTPError as error:
raise RuntimeError(f"Channel request failed: HTTP {error.code}") from error
if payload.get("error") or payload.get("status") != "done":
raise RuntimeError("Channel request did not complete. Check Request History before retrying.")
if not isinstance(payload.get("results"), list) or not payload["results"]:
raise RuntimeError("Expected a channel result")
channel = payload["results"][0]
videos = channel.get("videos")
if not isinstance(videos, list):
raise RuntimeError("Expected a videos array")
ids = list(dict.fromkeys(
row["videoId"] for row in videos
if isinstance(row.get("videoId"), str)
and re.fullmatch(r"[A-Za-z0-9_-]{11}", row["videoId"])
))
Path("channel.json").write_text(json.dumps({
"requestedHandle": handle, "requestedLimit": limit,
"channel": channel, "usage": payload.get("usage"),
}, indent=2), encoding="utf-8")
Path("video-ids.txt").write_text("".join(video_id + "\n" for video_id in ids), encoding="utf-8")
print(f"Saved {len(videos)} returned entries and {len(ids)} unique video IDs")
print("Reported channel video count:", channel.get("videoCount"))
python3 channel-videos.py
Utiliser les ID pour une requête complémentaire ciblée
La réponse de la chaîne contient des fiches vidéo compactes : ID, titre, durée, nombre de vues, date de publication et miniature, selon les données disponibles. Pour obtenir plus de détails, transmettez l’un de ces ID à youtube_metadata. Lisez l’ID dans le fichier enregistré au lieu de l’extraire d’un titre ou de l’URL d’une miniature.
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}
Envoyez ce corps de requête au même endpoint en temps réel. Remplacez la valeur d’exemple par un véritable ID de 11 caractères. Pour les sous-titres, consultez le guide de sélection de la langue des sous-titres pour choisir une piste adaptée avant d’envoyer la requête.
Prévoir les collectes récurrentes et les volumes plus importants
Conservez les ID vidéo déjà traités. Comparez les prochains instantanés à cet ensemble pour éviter de répéter les mêmes traitements.
Associez une date de collecte à vos instantanés. Les compteurs peuvent évoluer et une vidéo peut devenir indisponible après avoir figuré dans la réponse d’une chaîne.
Un instantané limité aux vidéos récentes peut omettre des vidéos anciennes ou publiées entre deux collectes espacées. Il ne constitue ni une archive complète ni un flux garantissant de signaler chaque vidéo exactement une fois.
Pour plusieurs requêtes complémentaires, choisissez le mode async ou Batch dans les limites de votre offre. Un lot regroupe les envois ; chaque élément reste facturable et vous devez toujours récupérer les résultats des jobs.
Consultez la référence de l’API Channel, l’API Video Metadata et le guide async et Batch. Pour commencer par une recherche, découvrez comment ajouter des outils de recherche à un agent IA.