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

{
  "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

{
  "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)