Overview
The official Tornado API node for n8n lets you download YouTube videos and Spotify podcasts directly in your automation workflows.Installation
Via npm (recommended)
Via Docker
Build from Source
Credentials Setup
1
Open n8n
Start n8n and go to Credentials in the sidebar
2
Add New Credential
Click New and search for Tornado API
3
Enter Details
- API Key: Your Tornado API key (starts with
sk_) - Base URL:
https://api.tornadoapi.io(default)
4
Save
Click Save to store your credentials
Available Operations
Job Operations
Batch Operations
Storage Operations
Account Operations
Example Workflows
Simple YouTube Download
-
Tornado API - Create Job
- Resource: Job
- Operation: Create
- URL:
https://youtube.com/watch?v=...
-
Tornado API - Wait for Completion
- Resource: Job
- Operation: Wait for Completion
- Job ID:
{{ $json.job_id }}
-
HTTP Request
- Method: GET
- URL:
{{ $json.s3_url }} - Response Format: File
Telegram Bot
- User sends YouTube URL to bot
- Tornado downloads the video
- Bot sends video back to user
Spotify Podcast Backup
- Runs weekly to backup new episodes
- Creates batch job for entire show
- Processes episodes in parallel
Create Job Options
S3 Configuration
Configure your own S3-compatible bucket to receive downloads:- Add Tornado API node
- Set Resource to Storage
- Set Operation to Configure Bucket
- Fill in your S3 credentials
- Amazon S3
- Cloudflare R2
- MinIO
- DigitalOcean Spaces
- Any S3-compatible storage
Error Handling
Use an IF node after Wait for Completion:- True: Process the downloaded file
- False: Handle the error (send notification, retry, etc.)
Tips
Use Webhooks
For long downloads, use webhooks instead of polling to avoid timeout issues.
Parallel Processing
Use Split In Batches for Spotify shows to process multiple episodes simultaneously.
Custom Storage
Configure your own S3 bucket to keep files organized and accessible.
Error Recovery
Add error handling nodes to retry failed downloads automatically.
