Threads Media Downloader 🎥📸

Download videos and images from Threads posts instantly. Extract high-quality media URLs from single posts or carousel content with complete metadata including captions, likes, dimensions, and user information.

---

📋 Table of Contents

• ✨ Features
• 🚀 Quick Start
• 🔧 Input Configuration
• 📊 Output Data Structure
• 💡 Use Cases
• 🎯 Best Practices
• ⚡ Performance & Limits
• ❓ FAQ
• 🛠️ Troubleshooting
• 🔑 SEO Keywords

---

✨ Features

Feature	Description
🎥 Video Downloads	Extract direct video URLs in multiple quality variants (720p, 1080p, etc.)
📸 Image Downloads	Get highest quality images from Threads posts
🎠 Carousel Support	Download all media items from carousel posts automatically
📦 Batch Processing	Process multiple Threads URLs in a single run
👤 User Metadata	Extract username, full name, profile picture, and verification status
💬 Post Details	Get captions, like counts, timestamps, and thread IDs
📐 Media Dimensions	Width and height information for all media items
📊 Clean Output	Organized table view with media type, URLs, and metadata
⚡ Fast & Reliable	Built-in rate limiting and automatic error handling
🔗 Direct URLs	Get direct CDN links ready for download or embedding

---

🚀 Quick Start

Step 1: Add Threads Post URLs

{
  "thread_urls": [
    "https://www.threads.net/@username/post/ABC123"
  ]
}

Step 2: Run the Actor

Click "Start" and monitor real-time progress in the console

Step 3: Download Results

Export media URLs in JSON, CSV, or Excel format

---

🔧 Input Configuration

Parameter	Type	Required	Description
thread_urls	Array	✅ Yes	List of Threads post URLs to extract media from

📝 Input Examples

Single Post:

{
  "thread_urls": [
    "https://www.threads.net/@creator/post/DRPk82ZkmU1"
  ]
}

Multiple Posts:

{
  "thread_urls": [
    "https://www.threads.net/@user1/post/ABC123",
    "https://www.threads.net/@user2/post/XYZ789",
    "https://www.threads.net/@user3/post/DEF456"
  ]
}

Carousel Post:

{
  "thread_urls": [
    "https://www.threads.com/@annecurtissmith/post/DRUIgZmkRYk"
  ]
}

🔗 Supported URL Formats

Format	Example	Supported
Standard	https://www.threads.net/@user/post/ABC123	✅ Yes
With Query	https://www.threads.net/@user/post/ABC123?xmt=...	✅ Yes
Short Link	https://www.threads.net/t/ABC123	✅ Yes
With Media	https://www.threads.com/@user/post/ABC123/media	✅ Yes

---

📊 Output Data Structure

🎬 Video Record Example

{
  "media_type": "video",
  "media_url": "https://scontent.cdninstagram.com/o1/v/t16/...",
  "source_url": "https://www.threads.net/@user/post/ABC123",
  "username": "creator",
  "full_name": "Creator Name",
  "caption_text": "Check out this amazing video!",
  "is_carousel": true,
  "carousel_index": 1,
  "width": 720,
  "height": 1280,
  "like_count": 24554,
  "taken_at": 1763566793,
  "thread_code": "ABC123",
  "thread_id": "3769393924386481461",
  "video_type": 101
}

📷 Image Record Example

{
  "media_type": "image",
  "media_url": "https://scontent.cdninstagram.com/v/t51.29350-15/...",
  "source_url": "https://www.threads.net/@user/post/XYZ789",
  "username": "photographer",
  "full_name": "Photo Creator",
  "caption_text": "Beautiful sunset 🌅",
  "is_carousel": false,
  "carousel_index": null,
  "width": 1220,
  "height": 2712,
  "like_count": 5432,
  "taken_at": 1763566793,
  "thread_code": "XYZ789",
  "thread_id": "3769393924386481462"
}

📈 Summary Record

{
  "summary": true,
  "success": true,
  "thread_url": "https://www.threads.net/@user/post/ABC123",
  "thread_code": "ABC123",
  "username": "creator",
  "media_count": 5,
  "video_count": 3,
  "image_count": 2,
  "is_carousel": true,
  "like_count": 24554,
  "fetched_at": "2025-11-21T13:30:00.000Z"
}

📋 Output Fields

Field	Type	Description
media_type	String	Type of media: "video" or "image"
media_url	String	Direct CDN URL to download the media
source_url	String	Original Threads post URL
username	String	Threads username of the post creator
full_name	String	Full name of the post creator
caption_text	String	Post caption/description text
is_carousel	Boolean	Whether media is part of a carousel
carousel_index	Number/Null	Position in carousel (1, 2, 3...) or null
width	Number	Media width in pixels
height	Number	Media height in pixels
like_count	Number	Number of likes on the post
taken_at	Number	Unix timestamp when post was created
thread_code	String	Unique thread identifier
thread_id	String	Internal thread ID
video_type	Number	Video quality type (101, 102, 103) - videos only

---

💡 Use Cases

Use Case	Description	Benefit
📥 Content Archiving	Save videos and images from favorite creators	Preserve content before deletion
📊 Media Analysis	Study content types and engagement patterns	Understand what performs best
🎨 Portfolio Building	Download your own Threads content	Create professional portfolios
🔬 Research Projects	Collect media for academic or market research	Analyze social media trends
💾 Backup Creation	Archive important posts and media	Never lose valuable content
🎯 Marketing Analysis	Study competitor content strategies	Improve your content strategy
📱 Social Listening	Monitor brand mentions with media	Track visual brand presence
🎬 Content Curation	Collect media for content creation	Build content libraries

---

🎯 Best Practices

✅ Do's

• ✅ Use valid URLs - Ensure all Threads post URLs are correct and accessible
• ✅ Batch processing - Process multiple URLs together for efficiency
• ✅ Check media_type - Filter results by "video" or "image" as needed
• ✅ Use carousel_index - Organize carousel content by slide number
• ✅ Export in JSON - Get complete metadata with all fields
• ✅ Verify public posts - Only public posts can be accessed
• ✅ Monitor dimensions - Check width/height for quality assessment

❌ Don'ts

• ❌ Invalid URLs - Don't use expired, deleted, or malformed URLs
• ❌ Private posts - Can't access media from private accounts
• ❌ Ignore errors - Check error messages for failed URLs
• ❌ Exceed limits - Respect rate limits for reliable performance
• ❌ Skip validation - Always verify URLs before processing

💡 Pro Tips

Tip	Benefit
Test with single URL first	Verify actor works before batch processing
Use carousel posts	Get multiple media items from one URL
Check video_type field	Identify different quality variants
Filter by dimensions	Find high-resolution media
Export to CSV	Easy analysis in spreadsheet tools
Save media_url	Direct links ready for download

---

⚡ Performance & Limits

📊 Performance Metrics

Metric	Value	Details
Processing Speed	2-3 seconds/post	Average time per Threads URL
Success Rate	99%+	High reliability for public posts
Media Extraction	Unlimited items	All carousel items extracted
Concurrent URLs	Multiple	Batch processing supported

🎬 Media Quality

Media Type	Quality	Format
Videos	Multiple variants	MP4 (Type 101, 102, 103)
Images	Highest available	JPG, WebP, PNG
Carousel	All items	Mixed videos & images

⚙️ Technical Limits

Limit	Value	Note
Rate Limit	1000 requests/hour	Built-in throttling
Timeout	30 seconds/request	Auto-retry on failure
URL Batch Size	No hard limit	Process responsibly
Media Size	No limit	Direct CDN URLs provided

---

❓ FAQ

🔐 Access & Authentication

Q: Do I need a Threads account to use this actor?
A: No. This actor extracts public media without requiring any login or authentication.

Q: Can I download media from private Threads accounts?
A: No. Only media from public posts is accessible. Private accounts cannot be accessed.

Q: Is this actor free to use?
A: The actor runs on Apify's platform. You'll need Apify credits based on your usage.

📥 Media Downloads

Q: What media formats are supported?
A: Videos (MP4) and Images (JPG, WebP, PNG) from Threads posts.

Q: Can I download carousel posts?
A: Yes! All media items from carousel posts are extracted with their index numbers.

Q: How many URLs can I process at once?
A: There's no hard limit, but process URLs in reasonable batches for best performance.

Q: Do I get the original quality?
A: Yes. Videos include multiple quality variants, and images are provided in highest available quality.

🎬 Videos & Images

Q: What video qualities are available?
A: Videos include multiple quality variants (Type 101, 102, 103) representing different resolutions.

Q: How do I filter only videos or only images?
A: Filter the output where media_type === "video" or media_type === "image".

Q: What are the video_type numbers?
A: Type 101, 102, 103 represent different quality levels. Lower numbers are typically higher quality.

Q: Can I get video thumbnails?
A: Yes. The output includes item_thumbnail_url field for video previews.

🛠️ Technical Questions

Q: What if a URL fails to process?
A: The actor continues processing other URLs and logs the error. Check the summary for details.

Q: How do I organize carousel media?
A: Use the carousel_index field (1, 2, 3...) to sort carousel items in order.

Q: Can I get post metadata?
A: Yes. Each record includes username, caption, likes, timestamp, and dimensions.

Q: What output formats are available?
A: JSON (complete data), CSV (spreadsheet), Excel (analysis), and XML.

📊 Data & Output

Q: What is the difference between thread_code and thread_id?
A: thread_code is the short URL identifier (e.g., "ABC123"), while thread_id is the internal numeric ID.

Q: How do I download the actual media files?
A: Use the media_url field which provides direct CDN links. You can download these URLs separately.

Q: Can I schedule regular extractions?
A: Yes. Use Apify's scheduling feature to run the actor automatically at set intervals.

---

🛠️ Troubleshooting

❌ Common Issues

Issue	Cause	Solution
No media found	Invalid or deleted post	Verify URL is correct and post exists
Empty results	Private account	Only public posts are accessible
Missing data field	Post unavailable	Check if post was deleted or made private
Timeout error	Network issue	Actor retries automatically
Invalid thread_url	Malformed URL	Use correct Threads URL format
All URLs failed	Invalid batch	Verify all URLs are valid public posts

🔍 Error Messages

"Missing or invalid thread_url"

• Check that the URL is a valid Threads post URL
• Ensure URL format: https://www.threads.net/@user/post/CODE

"Unexpected response: missing data field"

• Post may be deleted or unavailable
• Verify the post exists by opening URL in browser

"All thread URLs failed to process"

• Check that all URLs are from public posts
• Verify URLs are correctly formatted

"Thread code: media"

• URL parsing error (fixed in latest version)
• Remove /media suffix from URL if present

✅ Best Troubleshooting Steps

1. Verify URL - Open the Threads URL in your browser to confirm it works
2. Check post status - Ensure the post is public and not deleted
3. Test single URL - Try one URL first before batch processing
4. Review logs - Check actor logs for specific error messages
5. Check output - Look at summary records for processing statistics

---

🔑 SEO Keywords

🎯 Primary Keywords

• Threads media downloader
• Threads video downloader
• Threads image downloader
• Download Threads videos
• Download Threads images
• Threads post downloader
• Meta Threads downloader
• Threads content downloader

📊 Secondary Keywords

• Extract Threads media
• Threads video extractor
• Threads image extractor
• Download from Threads
• Threads carousel downloader
• Threads media scraper
• Save Threads videos
• Save Threads images
• Threads content extractor
• Threads media URL extractor

🔍 Long-tail Keywords

• How to download videos from Threads
• How to download images from Threads posts
• Extract media from Threads carousel
• Download Threads post media
• Get direct URL from Threads video
• Threads media downloader tool
• Bulk download Threads media
• Threads video and image extractor
• Download multiple Threads posts
• Threads media backup tool
• Extract Threads post content
• Threads media archiving tool

📱 Related Terms

• Meta Threads scraper
• Threads data extraction
• Threads API alternative
• Threads content backup
• Social media downloader
• Threads automation tool
• Threads media collector
• Instagram Threads downloader

---

🚀 Get Started Now

Download your first Threads media in under 60 seconds!

Perfect For:

✅ Content creators
✅ Social media managers
✅ Digital marketers
✅ Researchers & analysts
✅ Archivists
✅ Portfolio builders

Use For:

📥 Content backup
📊 Media analysis
🎨 Portfolio creation
🔬 Research projects
💾 Content archiving
🎯 Competitor analysis

Benefits:

⚡ Direct CDN URLs
📦 Complete metadata
🎠 Carousel support
📊 Batch processing
🎥 Multiple quality variants
📸 Highest quality images

---

📞 Support & Resources

Need help? Check these resources:

• 📖 Documentation - Complete guide above
• ❓ FAQ - Common questions answered
• 🛠️ Troubleshooting - Error solutions
• 💬 Apify Support - Contact Apify team

---

🔗 Related Apify Actors

Explore more Threads scrapers and tools:

• Threads Scraper Lite - Lightweight Threads scraper
• Threads Search Scraper - Search Threads posts
• Meta Threads Profile Scraper - Extract profile data
• Meta Threads User Media Scraper - User media scraper
• Threads User Following Scraper - User following scraper
• Threads User Followers Scraper - User followers scraper
• Threads Replies Scraper - Replies scraper
• Threads Scraper Pro - User Post scraper

---

Built for the Apify community. Download smarter, archive better. ❤️

This actor extracts publicly available data from Threads. Always respect content creators' rights and platform terms of service.