Downloader de vídeos do YouTube com n8n

Crie automação poderosa de downloads de vídeo usando a plataforma de automação de workflows n8n e a Hunt API. Arquive conteúdo, extraia áudio para podcasts e crie workflows de media inteligentes sem programar.

Quick Start com a Hunt API

A Video Download API funciona de forma assíncrona. Inicia um job de download e depois recupera os resultados usando o ID do job.

Passo 1: Iniciar Download

Use a Hunt API nos seus workflows n8n para iniciar um download de vídeo:

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

Query Parameters:

• query: o URL do vídeo para descarregar (obrigatório)
• video_quality: best (por defeito), 1080p, 720p, etc.
• download_type: audio_video (por defeito), audio (extrair apenas áudio) ou video

Exemplo de resposta:

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

Passo 2: Obter resultado do Job

Após esperar que o job termine, obtenha o resultado:

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

Exemplo de resposta (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"
    }
}

Para metadados sem descarregar, use GET https://api.huntapi.com/v1/media/metadata?query=... (síncrono).

Funcionalidades principais

• Downloader universal: suporte para múltiplas plataformas de vídeo
• Opções de formato: descarregar vídeo completo, apenas vídeo, ou extrair áudio
• Controlo de qualidade: selecionar de 360p até à melhor qualidade disponível
• Extração de metadados: títulos, miniaturas, número de visualizações e descrições
• Processamento assíncrono: lidar com ficheiros grandes de forma fiável com arquitetura baseada em jobs

Exemplo de workflow n8n

Como a API é assíncrona, a melhor prática é implementar um loop de polling:

1. Iniciar Download

• Node: HTTP Request
• Action: chamar GET /video/download
• Output: devolve job_id

2. Wait Loop

• Node: Wait
• Settings: esperar 5-10 segundos

3. Check Status

• Node: HTTP Request
• Action: chamar GET /jobs/:id usando o job_id do passo 1

4. Condition (If)

• Node: If
• Condition: {{$json.status}} igual a CompletedJob
• True: avançar para processar o ficheiro
• False: ligar de volta ao node Wait (Passo 2)

Casos de uso comuns

Automação de Podcast

Converta automaticamente conteúdo de vídeo em áudio. Defina download_type como audio para extrair MP3s de links de vídeo para o seu feed de podcast.

Monitorização de marca

Descarregue e arquive automaticamente vídeos que mencionam a sua marca ou produtos para compliance e registo.

Reaproveitamento para redes sociais

Descarregue versões de alta qualidade (video_quality: "1080p") do seu conteúdo para editar e republicar em diferentes plataformas.

Guia de configuração detalhado

Passo 1: Configurar o pedido de início 🎬

1. Arraste um node HTTP Request para a sua tela (renomeie para “Initiate Download”).
2. Method: selecione GET.
3. URL: introduza https://api.huntapi.com/v1/video/download.
4. Authentication:
   • Adicionar Header: Nome x-api-key, Valor YOUR_API_KEY.
5. Query Parameters:
   • Adicionar parâmetro: Nome query, Valor https://www.youtube.com/watch?v=....

Passo 2: Criar um loop de polling 🔄

Para lidar com tempos de processamento variáveis, crie um loop que verifica o estado até terminar:

1. Adicionar um Wait Node: ligue-o após o pedido de início. Defina para esperar 5 segundos.
2. Adicionar um Check Status Node: adicione um HTTP Request após o Wait.
   • URL: https://api.huntapi.com/v1/jobs/{{ $node["Initiate Download"].json.job_id }} (referencie o primeiro node).
   • Header: x-api-key.
3. Adicionar um If Node: ligue-o após o Check Status.
   • Condition: String {{ $json.status }} Equal to CompletedJob.
4. Fechar o loop:
   • Ligue a saída False do If de volta à entrada do node Wait.
   • Ligue a saída True aos seus próximos passos (por ex. Upload para Drive).

Passo 3: Processar o ficheiro 💾

Ligado à saída True do seu If node, agora pode usar o resultado:

• A URL de download está em {{ $json.result.response }}.
• Os metadados estão em {{ $json.result.metadata }}.