Automation & Workflow

YouTube-video’s downloaden met n8n

Gebruik YouTube-video’s downloaden met n8n met Hunt

Bouw krachtige video-downloadautomatisering met het n8n workflow automation platform en de Hunt API. Archiveer content, extraheer audio voor podcasts en maak slimme mediaworkflows zonder te coderen.

Quick Start met Hunt API

De Video Download API werkt asynchroon. Je start een downloadjob en haalt daarna de resultaten op met de job ID.

Stap 1: Download starten

Gebruik de Hunt API in je n8n-workflows om een video-download te starten:

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

Query Parameters:

• query: de URL van de video om te downloaden (vereist)
• video_quality: best (standaard), 1080p, 720p, enz.
• download_type: audio_video (standaard), audio (alleen audio extraheren) of video

Response Example:

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

Stap 2: Jobresultaat ophalen

Nadat je hebt gewacht tot de job is voltooid, haal je het resultaat op:

GET https://huntapi.com/api/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",
    "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"
    }
}

Belangrijkste features

• Universele downloader: ondersteuning voor meerdere videoplatformen
• Formaatopties: download volledige video, alleen video of extraheer audio
• Kwaliteitscontrole: kies van 360p tot de best beschikbare kwaliteit
• Metadata-extractie: titels, thumbnails, views en beschrijvingen
• Asynchrone verwerking: betrouwbare verwerking van grote bestanden via job-architectuur

n8n workflow-voorbeeld

Omdat de API asynchroon is, is best practice om een polling loop te implementeren:

1. Download starten

• Node: HTTP Request
• Action: call GET /video/download
• Output: retourneert job_id

2. Wait Loop

• Node: Wait
• Settings: wacht 5-10 seconden

3. Status checken

• Node: HTTP Request
• Action: call GET /jobs/:id met job_id uit stap 1

4. Voorwaarde (If)

• Node: If
• Condition: {{$json.status}} gelijk aan CompletedJob
• True: ga verder om het bestand te verwerken
• False: verbind terug naar de Wait node (Stap 2)

Veelvoorkomende use cases

Podcast-automatisering

Converteer videocontent automatisch naar audio. Zet download_type op audio om MP3’s te extraheren uit videolinks voor je podcastfeed.

Brand monitoring

Download en archiveer automatisch video’s die je merk of producten noemen voor compliance en archivering.

Social media repurposing

Download hoge kwaliteit versies (video_quality: "1080p") van je content om te bewerken en opnieuw te posten op verschillende platformen.

Gedetailleerde configuratiegids

Stap 1: Configureer de initiate request 🎬

1. Sleep een HTTP Request node naar je canvas (hernoem naar “Initiate Download”).
2. Method: selecteer GET.
3. URL: voer https://huntapi.com/api/v1/video/download in.
4. Authentication:
   • Voeg Header toe: Naam x-api-key, Waarde YOUR_API_KEY.
5. Query Parameters:
   • Voeg Parameter toe: Naam query, Waarde https://www.youtube.com/watch?v=....

Stap 2: Maak een polling loop 🔄

Om variërende verwerkingstijden te ondersteunen, maak je een loop die de status blijft checken tot het klaar is:

1. Voeg een Wait Node toe: verbind na je Initiate Request. Zet deze op 5 seconden wachten.
2. Voeg een Check Status Node toe: voeg een HTTP Request node toe na de Wait node.
   • URL: https://huntapi.com/api/v1/jobs/{{ $node["Initiate Download"].json.job_id }} (verwijs naar de eerste node).
   • Header: x-api-key.
3. Voeg een If Node toe: verbind na de Check Status node.
   • Condition: String {{ $json.status }} Equal to CompletedJob.
4. Sluit de loop:
   • Verbind de False output van de If node terug naar de input van de Wait node.
   • Verbind de True output met je volgende stappen (bijv. upload naar Drive).

Stap 3: Verwerk het bestand 💾

Verbonden aan de True output van je If node kun je nu het resultaat gebruiken:

• De download-URL staat in {{ $json.result.response }}.
• Metadata staat in {{ $json.result.metadata }}.