Threads Media and Metadata Extractor Extract media files and comprehensive metadata from Threads posts with high reliability and structured output. This Apify actor handles Threads URLs and provides detailed information about posts, images, videos, user profiles, and engagement statistics. ## Features - 🧵 Media Extraction: Download high-quality videos and images from Threads posts - 📊 Rich Metadata: Get comprehensive post information including user details, statistics, and content descriptions - 🔍 Flexible URLs: Support for all Threads URL formats (threads.com) - 📱 Raw Data Option: Access to complete Threads API response for advanced use cases - ⚡ Fast & Reliable: Built on proven extraction technology with robust error handling - 💰 Cost-Effective: Pay-per-use pricing at just $0.005 per extraction ## Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | url | string | ✅ | Threads post URL (supports threads.com/@username/post/POST_ID format) | | raw | string | ❌ | Include raw Threads API response with extended metadata (default: undefined) | ### Example Input json { "url": "https://www.threads.com/@username/post/DKUq2_EgVUF", "raw": "raw" } ## Supported URL Formats This actor supports Threads URL variations: - https://www.threads.com/@username/post/POST_ID - https://threads.com/@username/post/POST_ID ### Example URLs: - Text posts: https://www.threads.com/@texasbluesalley/post/DKUq2_EgVUF - Image posts: https://www.threads.com/@dcfilmnews/post/DKTQvOotZdp - Video posts: https://www.threads.com/@mariners/post/DKTSy7DN1eN - Multiple images: https://www.threads.com/@unmethodicall/post/DKS_8q1SBzt - Quote posts: https://www.threads.com/@slev_kelevra/post/DKVCLrURTTF ## Output Format The actor returns structured data containing: ### User Information - Profile name and display name - Profile picture URL - Verification status - Username and user ID ### Content Details - Post link and unique identifier - Post text/description with proper formatting - Publication timestamp - Media files (videos/images) with download URLs - Post type and thread information ### Engagement Statistics - Like count - Comment count (direct replies) - Share/repost count - Quote count ### Example Output json { "type": "threads", "user": { "name": "texasbluesalley", "displayName": "Texas Blues Alley", "pictures": { "url": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-19/..." }, "verified": true }, "content": { "link": "https://threads.com/@texasbluesalley/post/DKUq2_EgVUF", "description": "Last night's \"Cold Shot\" lesson was DOA on YouTube...", "title": null, "postedDate": "2025-01-27T20:14:37.000Z", "adult": false, "media": [ { "type": "photo", "url": "https://external-atl3-2.xx.fbcdn.net/...", "thumbnail": "https://external-atl3-2.xx.fbcdn.net/...", "size": { "width": 612, "height": 612 } } ], "statistics": { "likes": 4, "comments": 3, "shares": 0 } } } ## Content Types Supported - Text Posts: Pure text content with mentions and links - Image Posts: Single images with captions - Video Posts: Video content with thumbnails - Carousel Posts: Multiple images in a single post - Quote Posts: Posts that quote other Threads posts - Link Previews: Posts with external link previews (YouTube, etc.) ## Error Handling The actor handles common Threads-related errors gracefully: | Error | Description | HTTP Status | |-------|-------------|-------------| | Invalid URL | The provided URL is not a valid Threads link | 400 | | Post Not Found | The Threads post has been deleted or doesn't exist | 404 | | Private Post | The post is from a private account | 404 | | Rate Limited | Too many requests to Threads servers | 429 | | Network Error | Connection issues or Threads downtime | 500 | ## Technical Details This actor is built using: - Apify SDK v3 for robust actor framework - Custom Threads Extractors with advanced HTML parsing - Cheerio for HTML parsing and data extraction - Axios for reliable HTTP requests - Node.js Runtime for optimal performance The extraction process parses Threads' embedded JSON data from the HTML response to extract comprehensive post information. ## Use Cases - Social Media Analytics: Track Threads performance metrics - Content Aggregation: Collect Threads content for platforms or dashboards - Market Research: Analyze trending content and user engagement - Media Archival: Backup Threads content with metadata - Academic Research: Study social media trends and behavior - Content Creation: Gather inspiration and analyze successful posts ## Support For questions, bug reports, or feature requests: - Create an issue in the actor's repository - Contact support through Apify Console - Check the Apify documentation for general usage help ## License This actor is provided as-is for legitimate use cases. Please respect Threads' Terms of Service and applicable data protection regulations when using this tool. --- Ready to extract Threads data? Run this actor now or integrate it into your application using the examples above. ## Related Actors Explore our other social media extraction actors: - TikTok Media and Metadata Retriever - Extract videos, images, and metadata from TikTok posts with support for all TikTok URL formats (vm.tiktok.com, vt.tiktok.com, www.tiktok.com)