Automate Video Downloads with n8n: Complete Integration Guide

n8n is an open-source workflow automation tool that connects hundreds of apps. Our official Tornado API node lets you integrate video downloads into any workflow—without writing code.

Installation

cd ~/.n8n/custom
npm install n8n-nodes-tornado-api

Credentials Setup

1. In n8n, go to Credentials in the sidebar
2. Click New and search for Tornado API
3. Enter your API key (starts with sk_)
4. Base URL: https://api.tornadoapi.io
5. Click Save

Available Operations

Job Operations

• Create — Create a download job for a YouTube/Spotify URL
• Get Status — Check the current status of a job
• Wait for Completion — Poll until the job completes or fails

Batch Operations

• Get Status — Check status of a Spotify batch download

Storage Operations

• Configure Bucket — Set up your own S3/R2 bucket
• Reset to Default — Revert to Tornado's managed storage

Example Workflows

Simple YouTube Download

Manual Trigger → Tornado API (Create) → Tornado API (Wait) → HTTP Request (Download)

This workflow creates a download job, waits for completion, then downloads the file.

Telegram Bot

Telegram Trigger → Tornado API (Create) → Tornado API (Wait) → Telegram (Send Video)

Users send a YouTube URL to your bot, Tornado downloads the video, and the bot sends it back to the user.

Scheduled Podcast Backup

Schedule Trigger → Tornado API (Create) → Split In Batches → Tornado API (Wait)

Runs weekly to backup new episodes from your favorite podcasts.

Create Job Options

Error Handling

Use an IF node after Wait for Completion:

Condition: {{ $json.status }} == "Completed"
True → Process the file
False → Handle error (send notification, retry, etc.)

Advanced Workflow: AI Video Processing Pipeline

Here's a more advanced workflow for teams building AI-powered short-form video tools. This workflow automatically downloads new videos, processes them with AI, and generates clips:

Schedule Trigger (hourly)
  → HTTP Request (fetch new video URLs from your queue)
  → Split In Batches
  → Tornado API (Create Job with webhook)
  → Wait for Webhook
  → IF (status == Completed)
    → True: HTTP Request (trigger AI analysis on the downloaded video)
    → False: Slack (send error notification)

This pattern is used by AI companies processing terabytes of YouTube content per month for automated clip generation. n8n handles the orchestration, Tornado handles the downloading (with anti-bot bypassing and direct cloud delivery), and your AI models handle the analysis.

Why n8n + Tornado?

Using n8n with Tornado is significantly easier than building custom download infrastructure:

• No code required — Build complex video processing workflows visually
• No proxy management — Tornado handles all anti-bot bypassing automatically
• No download infrastructure — No servers to provision, no yt-dlp to maintain
• Direct cloud delivery — Videos go straight to your S3/R2/Azure/GCS bucket
• Scale on demand — Process hundreds of videos per hour without changing your workflow

While tools like yt-dlp require complex scripting and break regularly due to YouTube's anti-bot changes, Tornado provides a stable API that n8n can rely on for automated workflows.

Monitoring and Debugging

Track your n8n workflow executions and Tornado job statuses:

• n8n execution history — Review each workflow run, including Tornado API responses
• Tornado dashboard — Monitor all jobs at dash.tornadoapi.io
• Webhook logs — Check that notifications are being received correctly

Next Steps

• Get your Tornado API key to start building workflows
• Learn about webhooks for advanced async workflows
• Use batch downloads for processing entire playlists
• Build AI training datasets with automated collection