API Marketplaces

Marketplace users can use platform storage when enabled, supply cloud storage credentials, or reuse previously saved credentials. Signed-link expiration and object retention are separate: the API generally requests a 24-hour link, but the configured bucket lifecycle controls retention. A supplied Azure SAS keeps its own expiry.

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	Saved/inline credentials, or platform storage when enabled
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	Disabled by default
Live Recording	Supported	Disabled by default
Video Clipping	Supported	Disabled by default

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

Use the host and request URL from your active RapidAPI listing. Send your subscription key to that gateway; it supplies the proxy secret and tenant identity required by Tornado. The subscription key alone is not direct Tornado authentication:

curl -X POST "https://YOUR_RAPIDAPI_HOST/jobs" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: YOUR_RAPIDAPI_HOST" \
  -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 request host/path and credentials supplied by the Zyla integration (replace the example host below). Adding zyla_ to an arbitrary token does not grant access:

curl -X POST "https://YOUR_ZYLA_INTEGRATION_HOST/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 can be omitted when saved credentials or platform storage are available. Platform fallback is controlled by MARKETPLACE_DEFAULT_STORAGE (enabled by default); if disabled, the request needs customer storage. Supplied credentials are validated and persistence is attempted for the marketplace identity, but a successful job admission does not guarantee that persistence succeeded. Your cloud account controls retention; temporary platform links should be consumed promptly.

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:

Secret data - Credentials should be sent only through the documented credential fields; do not put them in workflow logs or public examples.
Saved for reuse when persistence succeeds - The service attempts to save settings for the authenticated marketplace identity using its configured secure storage.
Validated - Supplied credentials pass shape/backend checks and a storage probe, or reuse a cached successful probe for up to five minutes. A write/delete probe alone does not prove that a supplied SAS allows a later read.

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

API Reference

Jobs

Bulk

Metadata

Batch Operations

User

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