Automation & Workflow

Télécharger des vidéos YouTube avec n8n

Utiliser Télécharger des vidéos YouTube avec n8n avec Hunt

Créez une automatisation puissante de téléchargement vidéo avec la plateforme d’automatisation de workflows n8n et l’API Hunt. Archivez du contenu, extrayez l’audio pour des podcasts et mettez en place des workflows média intelligents sans code.

Démarrage rapide avec l’API Hunt

L’API de téléchargement vidéo fonctionne de manière asynchrone. Vous initiez un job de téléchargement puis récupérez le résultat via l’ID du job.

Étape 1 : initier le téléchargement

Utilisez l’API Hunt dans vos workflows n8n pour démarrer un téléchargement vidéo :

GET https://huntapi.com/api/v1/video/download
x-api-key: YOUR_API_KEY

Paramètres de requête :

• query : l’URL de la vidéo à télécharger (requis)
• video_quality : best (par défaut), 1080p, 720p, etc.
• download_type : audio_video (par défaut), audio (extraction audio uniquement) ou video

Exemple de réponse :

{
    "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Étape 2 : récupérer le résultat du job

Après avoir attendu la fin du job, récupérez le résultat :

GET https://huntapi.com/api/v1/jobs/0193443f-fb80-9d19-29ba-82bc77c7cd84
x-api-key: YOUR_API_KEY

Exemple de réponse (Completed) :

{
    "id": "0193305e-e144-a995-3acc-6703bb48e13a",
    "success": true,
    "status": "CompletedJob",
    "endpoint": "/api/video/download",
    "created_at": "2024-11-15T15:09:04.709497Z",
    "started_at": "2024-11-15T15:09:04.714422Z",
    "duration_ms": 99592,
    "args": {
        "query": "https://yt.com/watch?v=..."
    },
    "result": {
        "metadata": {
            "ext": "webm",
            "title": "The New Claude 3.5 Sonnet",
            "thumbnail": "https://i.ytimg.com/vi/...",
            "view_count": 82398,
            "upload_date": 1729641600
        },
        "response": "https://s3.huntapi.com/videos/32f88fc4-e728-4c45-b27c-6ee539575595.webm"
    }
}

Fonctionnalités clés

• Téléchargeur universel : support de multiples plateformes vidéo
• Options de format : télécharger la vidéo complète, la vidéo seule ou extraire l’audio
• Contrôle de qualité : sélection de 360p jusqu’à la meilleure qualité disponible
• Extraction de métadonnées : titres, miniatures, vues et descriptions
• Traitement asynchrone : gérer les fichiers volumineux de façon fiable via une architecture basée sur des jobs

Exemple de workflow n8n

Comme l’API est asynchrone, la bonne pratique est d’implémenter une boucle de polling :

1. Initier le téléchargement

• Nœud : HTTP Request
• Action : appeler GET /video/download
• Sortie : retourne job_id

2. Boucle d’attente

• Nœud : Wait
• Paramètres : attendre 5 à 10 secondes

3. Vérifier le statut

• Nœud : HTTP Request
• Action : appeler GET /jobs/:id en utilisant le job_id de l’étape 1

4. Condition (If)

• Nœud : If
• Condition : {{$json.status}} égal à CompletedJob
• Vrai : continuer pour traiter le fichier
• Faux : reconnecter vers le nœud Wait (Étape 2)

Cas d’usage courants

Automatisation de podcast

Convertissez automatiquement du contenu vidéo en audio. Définissez download_type sur audio pour extraire des MP3 à partir de liens vidéo pour votre flux podcast.

Brand monitoring

Téléchargez et archivez automatiquement des vidéos qui mentionnent votre marque ou vos produits pour la conformité et l’archivage.

Réutilisation de contenu social media

Téléchargez des versions haute qualité (video_quality: "1080p") de votre contenu pour le monter et le republier sur différentes plateformes.

Guide de configuration détaillé

Étape 1 : configurer la requête d’initiation 🎬

1. Glissez un nœud HTTP Request sur le canvas (renommez-le “Initiate Download”).
2. Method : sélectionnez GET.
3. URL : entrez https://huntapi.com/api/v1/video/download.
4. Authentication :
   • Ajoutez un header : nom x-api-key, valeur YOUR_API_KEY.
5. Query Parameters :
   • Ajoutez un paramètre : nom query, valeur https://www.youtube.com/watch?v=....

Étape 2 : créer une boucle de polling 🔄

Pour gérer des temps de traitement variables, créez une boucle qui vérifie l’état jusqu’à ce que ce soit terminé :

1. Ajoutez un nœud Wait : connectez-le après la requête d’initiation. Configurez-le pour attendre 5 secondes.
2. Ajoutez un nœud Check Status : ajoutez un nœud HTTP Request après le Wait.
   • URL : https://huntapi.com/api/v1/jobs/{{ $node["Initiate Download"].json.job_id }} (référence au premier nœud).
   • Header : x-api-key.
3. Ajoutez un nœud If : connectez-le après le Check Status.
   • Condition : chaîne {{ $json.status }} Equal to CompletedJob.
4. Fermez la boucle :
   • Connectez la sortie False du nœud If à l’entrée du nœud Wait.
   • Connectez la sortie True à vos étapes suivantes (ex. upload vers Drive).

Étape 3 : traiter le fichier 💾

Connecté à la sortie True de votre nœud If, vous pouvez maintenant exploiter le résultat :

• L’URL de téléchargement se trouve dans {{ $json.result.response }}.
• Les métadonnées sont dans {{ $json.result.metadata }}.