Video download API to cloud storage

Download YouTube videos to S3. Or to GCS, Azure Blob, R2, Alibaba OSS or Google Drive.

Send a YouTube URL and the finished MP4 or audio file is written to your own Amazon S3 bucket. Google Cloud Storage, Azure Blob Storage, Cloudflare R2, Alibaba OSS, Google Drive and S3-compatible buckets work the same way. Video up to 2160p, and failed jobs are never billed.

Create my account Talk to the team
100 GB free for 7 days for eligible new accounts. Run one job type next to your pipeline.
7storage destination types
2160pmax video resolution
0 / 236,054extraction failures, 14 days, Oct 2026

What delivery to your own cloud storage gives you

Files land in your bucket
Each completed file is written into the bucket you configure, and the job status and webhook return a signed download link to it. Your servers do not download the file and upload it again.
Seven kinds of destination
Amazon S3, Cloudflare R2, Google Cloud Storage, Azure Blob Storage, Alibaba OSS, Google Drive (a folder in a Shared Drive) and S3-compatible storage such as MinIO, Wasabi, Backblaze B2, DigitalOcean Spaces, Scaleway or OVHcloud.
Your folder layout
Set a base folder and a folder prefix on the destination, and a folder per job. A playlist batch uses a folder named after the collection when you set none. The job list returns each file’s object key, so you can find it after its link expires.
A fallback destination
In the dashboard, name a second destination and a transfer deadline between 30 and 300 seconds. If your primary storage does not take the file within that deadline, it goes to the fallback, then to Tornado storage. Each completed job records which one received it.
Designed for developers

One POST. We do the rest.

This request uses the destination saved for your API key. To send one job elsewhere, add an inline storage object for S3, Azure Blob, GCS or OSS. After the first job, open the object in your bucket and its download link from the network that will use it.

POST /jobs
curl --fail-with-body https://api.tornadoapi.io/jobs \
  -H "x-api-key: $TORNADO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://youtube.com/watch?v=aqz-KE-bpKQ",
  "format": "mp4"
}'
FAQ

Questions, answered.

Something else on your mind? Talk to the team. Bring a sample URL or a job ID.

How do I download a YouTube video to S3?

Save your bucket once: bucket name, region, access key ID and secret access key, in the dashboard or through the API for one API key. Then send the YouTube URL. The finished file is written to your bucket, and the job returns a signed download link that is generally valid for 24 hours.

Which cloud storage providers are supported?

Amazon S3, Cloudflare R2, Google Cloud Storage, Azure Blob Storage, Alibaba OSS, Google Drive and any S3-compatible bucket, such as MinIO, Wasabi, Backblaze B2 or DigitalOcean Spaces. Google Drive needs a folder in a Shared Drive, because a service account has no storage quota of its own.

Which permissions does the storage key need?

For S3: s3:PutObject, s3:GetObject, s3:DeleteObject and s3:AbortMultipartUpload on the bucket; s3:ListBucket is not required. Without s3:GetObject, uploads succeed but every download link returns 403. For Google Cloud Storage, grant Storage Object User on the bucket; Storage Object Creator alone is not enough.

How are my storage credentials stored?

Credentials entered in the dashboard are written to a dedicated secrets vault, not to the application database, and are shown masked when you read the configuration back. Give Tornado a key limited to the bucket it delivers to.

Does an expired download link mean the file was deleted?

No. The link only controls access through that URL. The file stays in your bucket under your own retention rules. Keep the object key from the job list if you need to fetch files directly after the link expires.

Will every YouTube URL work?

Availability depends on the source, access restrictions and supported output options. Private, removed, members-only and region-restricted videos end with a recorded outcome that explains why. Submit content you are authorized to use; access to a public URL does not grant rights to reuse it.

How is usage billed?

Billing uses billable volume under your account’s plan. A billing floor can make it differ from the delivered file size, especially for audio or clips. Your cloud provider can charge separately for storage, requests or transfers. Failed jobs are never billed.