Pricing

Rating

Developer

Actor stats

Categories

Share

🎵 Transcript Downloader - Instagram Audio Scraper Extractor & Downloader

Convert Instagram reels and video posts into downloadable audio files using the Transcript Downloader API. Ideal for music extraction, content repurposing, and offline listening. Works in bulk, with optional storage to Apify key-value store.

📚 API Documentation

For complete API reference, endpoint details, and advanced usage examples, visit our official documentation:

Transcript Downloader API Documentation

Get Your API Key • API Pricing

✨ Features

• 📁 Bulk processing of multiple Instagram content URLs
• 🎬 Supports reels and posts with video content
• 🖼️ Image detection - identifies image-only posts (no audio)
• 🕒 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

{
"contentUrls":[
"https://www.instagram.com/reel/ABC123",
"https://www.instagram.com/p/XYZ789"
],
"apiToken":"your-api-token",
"downloadToApify":true,
"maxWaitTime":10,
"pollingInterval":30
}

📤 Output Format

Each content URL generates an output record with metadata and processing info:

Successful Response (Audio Extracted)

{
"contentUrl":"https://www.instagram.com/reel/ABC123",
"id":"01KB21QX05P6B4JA7FJHTM7AWE",
"type":"instagram_audio",
"status":"success",
"duration":"00:00:30",
"cost":"0.050",
"audio_url":"https://drive.transcriptdownloader.com/audios/instagram-ABC123xyz.mp3?Expires=...",
"storage_key":"instagram-ABC123.mp3"
}

No Audio Response (Image-Only Post)

{
"contentUrl":"https://www.instagram.com/p/XYZ789",
"status":"no_audio",
"message":"This content does not contain audio.",
"download_id":"01KB21QX05P6B4JA7FJHTM7AWE",
"cost":"0.025"
}

Failed Response

{
"contentUrl":"https://www.instagram.com/p/INVALID",
"status":"failed",
"error":"Invalid Instagram URL. Must be a post (/p/) or reel (/reel/) URL."
}

🚀 How to Use

1. Get your API token from Transcript Downloader
2. Add one or more Instagram post/reel URLs (must include /p/ or /reel/)
3. Set downloadToApify to true if you want files saved to storage
4. Run the actor and access results in the dataset or key-value store

🔗 Supported URL Formats

The actor supports Instagram post and reel URLs:

✅ https://www.instagram.com/p/SHORTCODE
✅ https://www.instagram.com/reel/SHORTCODE
✅ http://www.instagram.com/p/SHORTCODE
✅ https://instagram.com/reel/SHORTCODE(without www)

❌ Not supported:

❌ Profile URLs(https://www.instagram.com/username/)
❌ Story URLs

❌ Error Handling

This actor includes robust handling for common issues:

Special Cases

• Image-only posts: Detected automatically and marked as no_audio status
• Private accounts: May return errors if content is not accessible
• Deleted content: Will fail with appropriate 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.

Processing Times

Breakdown by content length:

• Short reels (< 30 seconds): ~30-90 seconds
• Medium videos (30s - 2 minutes): ~1-3 minutes
• Long videos (2-5 minutes): ~2-5 minutes
• Download to Apify: Additional 5-15 seconds per file when enabled

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 content item 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

{
"contentUrls":[
"https://www.instagram.com/reel/ABC123",
"https://www.instagram.com/p/XYZ789"
],
"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
• ⏳ Keep pollingInterval at 30 seconds as recommended by the API
• 🔐 Keep your apiToken secret (never log it)
• 🧠 Monitor output for incomplete or failed downloads
• 🖼️ Check for no_audio status on image-only posts
• 🗂️ Store large audio files in Apify only when needed
• 🎯 Mix posts and reels in the same run

💰 Pricing & Billing

The Transcript Downloader API used by this actor requires a valid API token. API usage is billed separately:

• Audio extraction: ~$0.05 per reel/video post
• Image-only detection: ~$0.025 per post (no audio extracted)
• Cost displayed: Exact cost shown in each response

📊 Very cost-effective for bulk audio extraction.
View full details and subscription plans on our pricing page

🎯 Use Cases

• 🎵 Music extraction: Extract audio from Instagram reels
• 📻 Content repurposing: Convert video content to audio format
• 🎙️ Podcast creation: Extract audio for podcast episodes
• 📱 Offline listening: Download audio for offline access
• 🔊 Audio analysis: Extract audio for transcription or analysis
• 🎬 Video to audio: Batch convert Instagram videos to MP3

📊 Monitoring & Analytics

Track your usage with the built-in logging:

• Total processed: Number of URLs processed
• Successful: Audio files successfully extracted
• No audio: Image-only posts detected
• Failed: URLs that encountered errors
• Success rate: Percentage of successful extractions

Example summary:

Instagram Audio Scraper completed {
totalProcessed:10,
successful:7,
noAudio:2,
failed:1,
successRate:'70.0%'
}

🔄 Integration with Other Actors

This actor works with the Instagram suite:

1. Profile Scraper → Get profile + recent posts
2. List Scraper → Get all posts/reels from profile
3. Audio Scraper (this actor) → Extract audio from reels/posts

Complete Workflow:

Profile → List → Filter Videos → Extract Audio

🙋 Support

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

For technical issues with this actor, check the run logs for detailed error messages.

📄 License

This actor is provided under the ISC License.

Made with ❤️ by Transcript Downloader | Website | API Dashboard