Pricing

Rating

Developer

Actor stats

Categories

Share

🎧 Transcript Downloader - Youtube Audio Scraper Extractor & Downloader

Convert YouTube videos into downloadable audio files using the Transcript Downloader API. Ideal for podcasting, offline listening, and content repurposing. Works in bulk, with optional storage to Apify key-value store.

✨ Features

• 📁 Bulk processing of multiple YouTube video IDs
• 🕒 Polling logic with automatic retries
• 🧠 Progress tracking and run logs
• 🗂️ Optional Apify file storage to key-value store
• 🔔 Webhook support: Receive results via webhook instead of polling
• 🔐 Secure API token-based authentication

🔧 Input Parameters

📥 Example Input

{
"videoIds":["Fqdz6A-5d04"],
"apiToken":"your-api-token",
"downloadToApify":true,
"maxWaitTime":10,
"pollingInterval":60
}

📤 Output Format

Each video generates an output record with metadata and processing info:

{
"videoId":"Fqdz6A-5d04",
"id":"01JW72M0AGW3M6R3QDCS30RD2P",
"type":"audio",
"duration":"01:47:55",
"cost":"1.079",
"status":"success",// pending, success, or failed
"created_at":"2025-01-23T00:30:50.000Z",
"audioUrl":"https://cdn.transcriptdownloader.com/audio/abc123.mp3",
"storedAt":"apify://key-value-store/audio-Fqdz6A-5d04"// If downloaded
}

🚀 How to Use

1. Get your API token from Transcript Downloader
2. Add one or more YouTube video IDs
3. Set downloadToApify to true if you want files saved
4. Run the actor and access results in the dataset or key-value store

❌ Error Handling

This actor includes robust handling for common issues:

If a video is already being processed, its ID will be returned in the error message.

⚠️ Rate Limiting & Performance

API Rate Limits

When rate limits are exceeded, the API returns 429 Too Many Requests. The actor handles this automatically with built-in retry logic.

Audio Download Cooldown

If you request audio for the same video within the 5-minute cooldown, the API returns 429 with a "Download again in X minute(s)" message. The actor handles duplicate requests gracefully.

Processing Times

Retry Behavior

The actor automatically retries on transient errors (429, 500, 503) with exponential backoff (base delay 1s, max delay 60s, up to 5 attempts). It does not retry on client errors (401, 403, 404) since those require user action.

Response Headers

The API returns rate limit headers you can monitor in logs:

🔔 Webhook Support

Instead of polling, you can receive results automatically via webhook. Pass a publicly reachable URL in the includeWebhook field, and the API will POST the results directly to your server when audio processing completes.

How It Works

1. The webhook URL is sent with the initial API request only (not during polling)
2. One webhook is fired per video when processing completes or fails
3. The webhook payload is the exact same JSON the API endpoint would return
4. Failed deliveries are retried up to 3 times (at 10s, 30s, and 60s intervals)

Webhook Headers

Each delivery includes these custom headers to identify the event:

Example with Webhook

{
"videoIds":["Fqdz6A-5d04"],
"apiToken":"your-token",
"includeWebhook":"https://your-domain.com/webhook"
}

Important Notes

• The URL must be publicly reachable (no localhost or private IPs)
• Your endpoint must accept POST requests and return a 2xx status
• Test your webhook URL first using the API test endpoint
• The webhook is registered once at request time — it cannot be added after a job has started

💡 Best Practices

• ✅ Respect rate limits to avoid 429 errors
• ⏳ Use polling wisely — longer intervals for large queues
• ⏳ Avoid re-requesting the same video within the 5-minute cooldown
• 🔐 Keep your apiToken secret (never log it)
• 🧠 Monitor output for incomplete or failed downloads
• 🗂️ Store large audio files in Apify only when needed

📈 Monitoring

Track performance and usage with Apify tools:

• Run history
• Success/failure rates
• Storage and resource usage
• Output file availability

💳 Pricing & Billing

The Transcript Downloader API used by this actor requires a valid API token. API usage is billed separately and is based on processing time and file size.

📊 We charge per minute of audio. Visit our site to checkout pricing. View full details and subscription plans on our pricing page

🙋 Support

Need help? Visit Transcript Downloader Support. We respond within 24 business hours.

📄 License

This actor is provided under the ISC License.