Automation & Workflow

Descargar videos de YouTube con n8n

Usar Descargar videos de YouTube con n8n con Hunt

Crea una automatización potente de descarga de videos usando la plataforma de automatización n8n y la API de Hunt. Archiva contenido, extrae audio para podcasts y crea workflows inteligentes sin escribir código.

Inicio rápido con Hunt API

La Video Download API funciona de manera asíncrona. Inicias un job de descarga y luego recuperas los resultados usando el ID del job.

Paso 1: Iniciar descarga

Usa Hunt API en tus workflows de n8n para iniciar una descarga de video:

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

Parámetros de consulta:

• query: la URL del video a descargar (requerido)
• video_quality: best (por defecto), 1080p, 720p, etc.
• download_type: audio_video (por defecto), audio (extraer solo audio) o video

Ejemplo de respuesta:

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

Paso 2: Obtener el resultado del job

Después de esperar a que el job se complete, recupera el resultado:

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

Ejemplo de respuesta (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"
    }
}

Funcionalidades clave

• Downloader universal: soporte para múltiples plataformas de video
• Opciones de formato: descargar video completo, solo video o extraer audio
• Control de calidad: seleccionar desde 360p hasta la mejor calidad disponible
• Extracción de metadatos: títulos, miniaturas, vistas y descripciones
• Procesamiento asíncrono: manejar archivos grandes de forma fiable con una arquitectura basada en jobs

Ejemplo de workflow en n8n

Como la API es asíncrona, la mejor práctica es implementar un bucle de polling:

1. Iniciar descarga

• Nodo: HTTP Request
• Acción: llamar a GET /video/download
• Salida: devuelve job_id

2. Bucle de espera

• Nodo: Wait
• Configuración: esperar 5–10 segundos

3. Comprobar estado

• Nodo: HTTP Request
• Acción: llamar a GET /jobs/:id usando el job_id del paso 1

4. Condición (If)

• Nodo: If
• Condición: {{$json.status}} igual a CompletedJob
• True: continuar para procesar el archivo
• False: volver al nodo Wait (Paso 2)

Casos de uso comunes

Automatización de podcasts

Convierte contenido de video en audio automáticamente. Configura download_type a audio para extraer MP3s desde enlaces de video para tu feed de podcast.

Monitoreo de marca

Descarga y archiva automáticamente videos que mencionen tu marca o productos para compliance y registro.

Reutilización para redes sociales

Descarga versiones de alta calidad (video_quality: "1080p") para editar y republicar en distintas plataformas.

Guía de configuración detallada

Paso 1: Configurar la solicitud de inicio 🎬

1. Arrastra un nodo HTTP Request al canvas (renómbralo a “Initiate Download”).
2. Method: selecciona GET.
3. URL: introduce https://huntapi.com/api/v1/video/download.
4. Authentication:
   • Añade Header: nombre x-api-key, valor YOUR_API_KEY.
5. Query Parameters:
   • Añade Parameter: nombre query, valor https://www.youtube.com/watch?v=....

Paso 2: Crear un bucle de polling 🔄

Para manejar tiempos de procesamiento variables, crea un bucle que revise el estado hasta que termine:

1. Añade un nodo Wait: conéctalo después de la solicitud de inicio. Configúralo para esperar 5 segundos.
2. Añade un nodo Check Status: añade un nodo HTTP Request después del Wait.
   • URL: https://huntapi.com/api/v1/jobs/{{ $node["Initiate Download"].json.job_id }} (referencia el primer nodo).
   • Header: x-api-key.
3. Añade un nodo If: conéctalo después del Check Status.
   • Condition: string {{ $json.status }} Equal to CompletedJob.
4. Cierra el bucle:
   • Conecta la salida False del nodo If de vuelta a la entrada del nodo Wait.
   • Conecta la salida True a tus siguientes pasos (p. ej., subir a Drive).

Paso 3: Procesar el archivo 💾

Conectado a la salida True del nodo If, ahora puedes usar el resultado:

• La URL de descarga está en {{ $json.result.response }}.
• Los metadatos están en {{ $json.result.metadata }}.