🐦 Twitter X Media Downloader - Download Videos & Photos in HD Quality

Download Twitter/X videos and photos in HD quality. Extract complete tweet metadata, engagement statistics, author details, media files, and direct download links. Fast, reliable Twitter media downloader and scraper for Apify.

📋 Table of Contents

• 🚀 Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 🔧 Configuration
• 📈 Performance
• ❓ FAQ
• 🛠️ Troubleshooting
• 📞 Support

🚀 Features

🎥 Media Downloads

• ✅ Videos & Photos - Download both Twitter/X videos and photo posts
• ✅ HD Quality - Download videos in highest quality available
• ✅ Multiple Quality Options - HD and SD video variants
• ✅ Photo Galleries - Extract all images from multi-photo tweets
• ✅ Batch Download - Process multiple tweets at once
• ✅ Fast & Reliable - Quick media extraction with retry logic
• ✅ Direct Download Links - Get direct URLs for all media

📊 Complete Data Extraction

• ✅ Tweet Content - Full text, display text, language
• ✅ Media Files - Videos, photos, thumbnails with direct links
• ✅ Engagement Stats - Likes, retweets, replies, quotes, bookmarks, views
• ✅ Author Details - Name, username, verification status, followers count
• ✅ Tweet Metadata - Creation date, conversation ID, reply information
• ✅ URLs & Links - All URLs mentioned in the tweet

🎯 Use Cases

• 📱 Content Creation - Download Twitter videos and photos for editing and reuse
• 📸 Media Collection - Save Twitter media galleries with all images
• 📊 Social Analytics - Track engagement metrics and tweet performance
• 📈 Trend Analysis - Monitor viral tweets and trending content
• 📚 Content Archiving - Backup tweets with complete metadata and media
• 💼 Marketing Research - Analyze competitor tweets and strategies
• 🎨 Portfolio Building - Save your Twitter content in HD quality
• 📰 Journalism - Archive news tweets and media for reference

⚡ Quick Start

Basic Usage

Simply add Twitter/X tweet URLs:

{
  "tweet_urls": [
    "https://twitter.com/username/status/1234567890"
  ]
}

Download from X.com

Works with both twitter.com and x.com URLs:

{
  "tweet_urls": [
    "https://x.com/username/status/1234567890"
  ],
  "include_metadata": true
}

Multiple Tweets

Download media from multiple tweets at once:

{
  "tweet_urls": [
    "https://twitter.com/user1/status/1234567890",
    "https://x.com/user2/status/0987654321",
    "https://twitter.com/user3/status/1122334455"
  ],
  "include_metadata": true
}

📊 Input Parameters

Parameter	Type	Required	Description	Default
tweet_urls	Array	✅ Yes	Twitter/X tweet URLs or tweet IDs	-
include_metadata	Boolean	❌ No	Include complete tweet metadata	true

Supported URL Formats

• https://twitter.com/username/status/TWEET_ID
• https://x.com/username/status/TWEET_ID
• https://www.twitter.com/username/status/TWEET_ID
• TWEET_ID (just the numeric ID)

📤 Output Data

Video Tweet Output

{
  "media_type": "video",
  "tweet_id": "1986587629740270045",
  "tweet_url": "https://twitter.com/katyperry/status/1986587629740270045",
  "text": "bandaids out now",
  "created_at": "Fri Nov 07 00:12:54 +0000 2025",
  
  "video_url_hd": "https://video.twimg.com/.../2048x1536/video.mp4",
  "video_url_sd": "https://video.twimg.com/.../360x270/video.mp4",
  "video_thumbnail": "https://pbs.twimg.com/.../thumb.jpg",
  "video_duration": 29496,
  "video_bitrate_hd": 25128000,
  
  "likes": 131095,
  "retweets": 18940,
  "replies": 5243,
  "quotes": 4273,
  "bookmarks": 6908,
  "views": "9329825",
  
  "author_name": "KATY PERRY",
  "author_username": "katyperry",
  "author_verified": true,
  "author_followers": 94446290
}

Photo Tweet Output

{
  "media_type": "photo",
  "tweet_id": "1802733304619336174",
  "text": "WOMAN'S WORLD SONG JULY 11",
  "photos": [
    {
      "url": "https://pbs.twimg.com/media/image1.jpg",
      "id": "1802733297946271744"
    }
  ],
  "photo_count": 1,
  "likes": 389046,
  "retweets": 46298,
  "views": "66501572",
  "author_username": "katyperry"
}

What You Get

• ✅ Media Type - Automatically detects video, photo, or text tweet
• ✅ Video Links - HD and SD quality download URLs
• ✅ Photo URLs - All images from multi-photo tweets
• ✅ Engagement Data - Likes, retweets, replies, quotes, bookmarks, views
• ✅ Tweet Content - Full text and display text
• ✅ Author Data - Name, username, verification, followers
• ✅ Tweet Details - Creation date, language, reply status

🔧 Configuration

Metadata Settings

• Include Metadata (true) - Extract complete tweet data with all engagement stats
• Minimal Data (false) - Extract only basic tweet and media information

What's Included

All tweets automatically include:

• Direct video download links (HD and SD quality)
• Photo URLs (for photo tweets)
• Complete engagement statistics (likes, retweets, views, etc.)
• Author profile details and verification status
• Tweet content and metadata
• Reply and conversation information

📈 Performance

• ⚡ Fast Processing - 2-3 seconds per tweet
• 🔄 Batch Support - Process multiple tweets simultaneously
• 🛡️ Reliable - Automatic retry
• 📊 Detailed Logs - Clear progress and error messages

❓ FAQ

Q: Can I download Twitter videos in HD quality?
Yes! The actor extracts HD and SD quality video URLs for all video tweets.

Q: Does it work with both twitter.com and x.com URLs?
Yes! Both twitter.com and x.com URLs are fully supported.

Q: Can I download photos from tweets?
Yes! The actor extracts all photos from single and multi-photo tweets.

Q: Can I download multiple tweets at once?
Yes! Add multiple tweet URLs to process them in a single run.

Q: What data is extracted?
Video/photo URLs, engagement stats (likes, retweets, views), author details, and complete tweet metadata.

Q: Are there usage limits?
Usage depends on your Apify subscription plan and API rate limits.

Q: Is this legal?
For personal use, research, and analysis. Respect copyright laws and Twitter's Terms of Service.

🛠️ Troubleshooting

Issue	Solution
Invalid Twitter URL	Verify the URL format is correct (twitter.com or x.com)
Tweet not found	Check if tweet exists and is publicly accessible
Rate limit exceeded	Wait a few minutes before retrying
No media found	Tweet may contain only text without media

Tips:

• Test tweet URLs in browser first
• Works with videos, photos, and text tweets
• Check actor logs for detailed error messages
• Start with single tweet before batch processing
• Private/protected tweets cannot be accessed

💡 Tips for Best Results

• Use valid, public Twitter/X tweet URLs
• Enable metadata for complete engagement statistics
• Process multiple tweets in batches for efficiency
• Both twitter.com and x.com URLs work perfectly
• Check logs if any tweet fails to process
• Video tweets will include multiple quality options

---

🏷️ Find Me

twitter downloader twitter video downloader twitter photo downloader download twitter twitter scraper twitter hd download twitter media downloader twitter video extractor twitter photo extractor twitter images twitter metadata twitter engagement stats twitter analytics twitter batch download twitter api download twitter videos download twitter photos twitter media api twitter data extractor twitter apify actor x downloader x video downloader x.com downloader twitter x scraper tweet downloader tweet media extractor twitter video saver x video saver

---

⭐ If this actor helps you, please rate it on Apify Store!

Built with ❤️ for Apify Platform