API Marketplaces

Marketplace users can either use Tornado storage (default: presigned URL valid 24 hours, file kept 24 hours) or provide their own cloud storage credentials for permanent delivery.

Supported Marketplaces

Tornado API is available on multiple API marketplaces, allowing you to use the service without managing your own API keys.

RapidAPI

The world’s largest API marketplace

Apify

Web scraping and automation platform

Zyla API Hub

Premium API marketplace

Key Differences from Direct API

Aspect	Direct API	Marketplace
Authentication	`x-api-key` header	Marketplace-specific headers
Storage	Pre-configured or inline	Tornado storage by default (24 h), or inline credentials
Billing	Your direct account plan / PAYG	Managed by the marketplace integration
Max Resolution	Subject to plan and source	720p default
Max File Size	Subject to API key and plan	512 MiB default
Max Duration	Subject to API key and plan	60 minutes default
Batch Downloads	Supported	Not available
Live Recording	Supported	Not available
Video Clipping	Supported	Not available

Marketplace features and limits depend on the integration configuration. Direct accounts can offer additional capabilities, subject to their own plan and key limits. Consult your response notices and the dashboard rather than assuming direct access is unlimited.

RapidAPI

Authentication

RapidAPI handles authentication automatically. Simply include your RapidAPI subscription key:

curl -X POST "https://tornado-api.p.rapidapi.com/jobs" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: tornado-api.p.rapidapi.com" \
  -d '{
    "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
    "format": "mp4",
    "storage": {
      "provider": "s3",
      "endpoint": "https://s3.amazonaws.com",
      "bucket": "my-videos",
      "region": "us-east-1",
      "access_key": "YOUR_ACCESS_KEY",
      "secret_key": "YOUR_SECRET_KEY"
    }
  }'

Subscription Tiers

Use the plans and limits shown on the active marketplace listing. A marketplace subscription tier does not by itself remove Tornado feature or admission limits.

Apify

Use Run mode in the Actor console or its run API. The current Actor implementation rejects Standby HTTP mode and requires completion tracking; wait_for_completion=false is not supported. Example Actor input:

{
  "urls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
  "max_resolution": "720",
  "format": "mp4"
}

Read results from the run’s dataset. Storage is optional and can be supplied in the Actor input. Use the input schema and pricing of the Actor version you run; do not use an old /jobs Standby example as the Actor run API contract.

Zyla API Hub

Authentication

Use the credentials supplied by the Zyla integration. Adding zyla_ to an arbitrary token does not grant access:

curl -X POST "https://zylalabs.com/api/tornado/jobs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zyla_YOUR_API_KEY" \
  -d '{
    "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
    "format": "mp4",
    "storage": {
      "provider": "blob",
      "account_name": "mystorageaccount",
      "container": "videos",
      "account_key": "YOUR_ACCOUNT_KEY"
    }
  }'

Storage Configuration

Storage credentials are optional. Without them, files are stored on Tornado’s infrastructure for 24 hours and served through a presigned URL valid 24 hours. Provide credentials (once — they are saved for your account) to deliver straight into your own S3/R2, Azure Blob, GCS or OSS bucket under your own retention policy.

Supported Providers

AWS S3 / Cloudflare R2 / MinIO

{
  "provider": "s3",
  "endpoint": "https://s3.amazonaws.com",
  "bucket": "my-bucket",
  "region": "us-east-1",
  "access_key": "AKIAIOSFODNN7EXAMPLE",
  "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "folder_prefix": "videos/",
  "base_folder": "downloads"
}

Azure Blob Storage

{
  "provider": "blob",
  "account_name": "mystorageaccount",
  "container": "mycontainer",
  "account_key": "YOUR_ACCOUNT_KEY",
  "folder_prefix": "videos/",
  "base_folder": "downloads"
}

Or with SAS Token:

{
  "provider": "blob",
  "account_name": "mystorageaccount",
  "container": "mycontainer",
  "sas_token": "sv=2021-06-08&ss=b&srt=sco...",
  "folder_prefix": "videos/",
  "base_folder": "downloads"
}

Google Cloud Storage

{
  "provider": "gcs",
  "project_id": "my-project",
  "bucket": "my-bucket",
  "service_account_json": "{\"type\":\"service_account\",...}",
  "folder_prefix": "videos/",
  "base_folder": "downloads"
}

Alibaba Cloud OSS

{
  "provider": "oss",
  "endpoint": "https://oss-cn-hangzhou.aliyuncs.com",
  "bucket": "my-bucket",
  "access_key_id": "LTAI...",
  "access_key_secret": "...",
  "folder_prefix": "videos/",
  "base_folder": "downloads"
}

Security

Your storage credentials are:

Never logged - Credentials are redacted in all logs
Saved for reuse - Marketplace storage settings can be persisted encrypted for the marketplace user so later requests can omit inline credentials
Validated - Credentials are tested before the job is accepted

Error Handling

Common errors for marketplace users:

Error	Description	Solution
Storage unavailable	The selected/default destination cannot be resolved or used	Check the returned error and configure an accessible destination
`Invalid storage credentials`	Credentials validation failed	Check your cloud provider credentials
`Invalid Apify token`	Apify authentication failed	Verify your Apify API token
`Invalid Zyla token format`	Unsupported credentials format	Use the credentials issued for the integration
`Batch downloads not available`	Marketplace users cannot use batch downloads	Use the direct API for batch downloads
`Live recording not available`	Marketplace users cannot record live streams	Use the direct API for live recording
`Clipping not available`	Marketplace users cannot use video clipping	Use the direct API for clipping

Get Started

Features

Storage guides

Integrations

Supported Marketplaces

RapidAPI

Apify

Zyla API Hub

Key Differences from Direct API

RapidAPI

Authentication

Subscription Tiers

Apify

Zyla API Hub

Authentication

Storage Configuration

Supported Providers

Security

Error Handling

​Supported Marketplaces

RapidAPI

Apify

Zyla API Hub

​Key Differences from Direct API

​RapidAPI

​Authentication

​Subscription Tiers

​Apify

​Zyla API Hub

​Authentication

​Storage Configuration

​Supported Providers

​Security

​Error Handling

Supported Marketplaces

Key Differences from Direct API

RapidAPI

Authentication

Subscription Tiers

Apify

Zyla API Hub

Authentication

Storage Configuration

Supported Providers

Security

Error Handling