Downloader di video YouTube con n8n

Crea una potente automazione di download video usando la piattaforma di automazione workflow n8n e la Hunt API. Archivia contenuti, estrai audio per podcast e crea workflow media intelligenti senza scrivere codice.

Quick Start con Hunt API

La Video Download API funziona in modo asincrono. Avvii un job di download e poi recuperi i risultati usando l’ID del job.

Step 1: Avvia il download

Usa la Hunt API nei tuoi workflow n8n per avviare un download video:

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

Query Parameters:

• query: l’URL del video da scaricare (richiesto)
• video_quality: best (default), 1080p, 720p, ecc.
• download_type: audio_video (default), audio (estrai solo audio) o video

Response Example:

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

Step 2: Ottieni il risultato del job

Dopo aver atteso che il job sia completato, recupera il risultato:

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

Response Example (Completed):

{
    "id": "0193305e-e144-a995-3acc-6703bb48e13a",
    "success": true,
    "status": "CompletedJob",
    "progress": 100,
    "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"
    }
}

Per i metadati senza scaricare, usa GET https://api.huntapi.com/v1/media/metadata?query=... (sincrono).

Funzionalità principali

• Downloader universale: supporto per più piattaforme video
• Opzioni di formato: scarica video completo, solo video o estrai audio
• Controllo qualità: seleziona da 360p fino alla migliore qualità disponibile
• Estrazione metadati: titoli, miniature, visualizzazioni e descrizioni
• Elaborazione asincrona: gestisci file grandi in modo affidabile con architettura a job

Esempio di workflow n8n

Dato che l’API è asincrona, la best practice è implementare un ciclo di polling:

1. Avvia il download

• Node: HTTP Request
• Action: chiama GET /video/download
• Output: restituisce job_id

2. Wait Loop

• Node: Wait
• Settings: attendi 5-10 secondi

3. Controlla lo status

• Node: HTTP Request
• Action: chiama GET /jobs/:id usando job_id dallo step 1

4. Condizione (If)

• Node: If
• Condition: {{$json.status}} uguale a CompletedJob
• True: procedi a processare il file
• False: collega di nuovo al node Wait (Step 2)

Use case comuni

Automazione podcast

Converti automaticamente contenuti video in audio. Imposta download_type su audio per estrarre MP3 da link video per il tuo feed podcast.

Brand monitoring

Scarica e archivia automaticamente video che menzionano il tuo brand o prodotti per compliance e conservazione.

Social media repurposing

Scarica versioni di alta qualità (video_quality: "1080p") dei tuoi contenuti per editarli e ripubblicarli su più piattaforme.

Guida di configurazione dettagliata

Step 1: Configura la richiesta di avvio 🎬

1. Trascina un node HTTP Request nella tua canvas (rinominalo “Initiate Download”).
2. Method: seleziona GET.
3. URL: inserisci https://api.huntapi.com/v1/video/download.
4. Authentication:
   • Aggiungi Header: nome x-api-key, valore YOUR_API_KEY.
5. Query Parameters:
   • Aggiungi parametro: nome query, valore https://www.youtube.com/watch?v=....

Step 2: Crea un loop di polling 🔄

Per gestire tempi di elaborazione variabili, crea un loop che controlla lo stato finché non è completato:

1. Aggiungi un Wait Node: collegalo dopo la richiesta di avvio. Imposta l’attesa a 5 secondi.
2. Aggiungi un Check Status Node: aggiungi un HTTP Request dopo il Wait node.
   • URL: https://api.huntapi.com/v1/jobs/{{ $node["Initiate Download"].json.job_id }} (riferimento al primo node).
   • Header: x-api-key.
3. Aggiungi un If Node: collegalo dopo il Check Status.
   • Condition: stringa {{ $json.status }} Equal to CompletedJob.
4. Chiudi il loop:
   • Collega l’uscita False dell’If node di nuovo all’input del node Wait.
   • Collega l’uscita True ai tuoi step successivi (es. upload su Drive).

Step 3: Processa il file 💾

Collegato all’uscita True del tuo If node, ora puoi usare il risultato:

• L’URL di download è in {{ $json.result.response }}.
• I metadati sono in {{ $json.result.metadata }}.