🐦 Twitter Video Downloader — X Video Download & Tweet Metadata

The most reliable Twitter Video Downloader on Apify. Extract direct MP4 download URLs at every available bitrate, complete tweet metadata, engagement metrics, and author details from any public Twitter/X video tweet — in bulk. No login. No API key. Residential proxy ready. Instant structured output.

---

📌 Table of Contents

• What Is This Actor?
• Why Use This Twitter Video Downloader?
• Use Cases
• Input Parameters
• Output Fields
• Example Input & Output
• Pricing & Free Trial
• Performance & Limits
• FAQ
• Changelog
• Legal & Terms of Use

---

🔍 What Is This Actor?

Twitter Video Downloader & X Video Metadata Extractor is a production-ready Apify actor that delivers direct MP4 download URLs at every available quality level — plus complete Twitter video metadata — from any public Twitter/X video tweet.

Provide one or many tweet URLs or tweet IDs and receive back a clean, consistently structured record for each video: tweet text, author profile, engagement metrics (likes, retweets, replies, views), thumbnail, duration, aspect ratio, and all available video quality URLs sorted by bitrate from highest to lowest.

This X video downloader works entirely without login, without Twitter API credentials, and without any manual steps. Paste your tweet URLs and get results instantly — whether you need one video or a thousand.

---

🚀 Why Use This Twitter Video Downloader?

Feature	This Actor	Manual Download	Browser Extensions	Twitter API
Twitter video downloader — bulk	✅	❌ One-by-one	❌ One-by-one	❌ Paid tier
All quality levels returned	✅ Every bitrate	⚠️ One quality	⚠️	❌
Twitter video metadata — full set	✅ 15+ fields	❌	❌	⚠️ Limited
Likes, retweets, replies & views	✅	❌	❌	⚠️ Paid
Author profile & username	✅	❌	❌	⚠️
Tweet text & display text	✅ Both	❌	❌	✅
Duration & aspect ratio	✅	❌	❌	❌
No login or API key	✅	✅	✅	❌ Required
Structured JSON — export-ready	✅	❌	❌	⚠️
CSV / Excel export	✅ Via Apify	❌	❌	❌

Bottom line: This X video downloader is the only actor that returns every available video quality alongside a complete Twitter video metadata record — engagement metrics, author details, and tweet content — in a single run with no credentials needed.

---

🎯 Use Cases

📥 Twitter Video Download & Archiving

• Download Twitter and X videos in bulk for backup before tweets are deleted or accounts suspended
• Archive brand videos, product announcements, and viral tweet content with full metadata
• Preserve public interest X videos as timestamped evidence or documentation records

📊 Twitter Video Metadata Research & Analytics

• Collect Twitter video metadata — likes, retweets, replies, views — for engagement benchmarking
• Analyze which video types and topics drive the highest engagement on Twitter/X
• Monitor competitor X video performance by tracking view and like counts over time

🤖 AI & Machine Learning Datasets

• Extract X video download URLs in bulk to build training datasets for video AI models
• Collect tweet text and descriptions for NLP, sentiment analysis, or content classification
• Scrape Twitter video metadata at scale for recommendation system or content moderation training

🔬 Social Media Research & Journalism

• Download Twitter videos and X content as verified evidence for investigative reporting
• Study virality patterns by correlating video engagement metrics with content type
• Build structured datasets of tweet videos for academic media research or platform studies

🛠️ Developer & Content Pipeline Integrations

• Build a Twitter video downloader pipeline that resolves MP4 URLs on demand for your application
• Automate X video ingestion into your media library, CMS, or content management platform
• Integrate Twitter video metadata into dashboards, monitoring tools, or analytics systems

🎓 Brand Monitoring & Marketing Intelligence

• Track how brand-related X video content performs across engagement dimensions
• Collect video metadata from key accounts in your industry for competitive analysis
• Monitor viral video trends on Twitter/X to inform content strategy decisions

---

⚙️ Input Parameters

{
  "tweetUrls": [
    "https://x.com/username/status/1234567890123456789",
    "https://twitter.com/username/status/9876543210987654321"
  ],
  "videoOnly":          false,
  "includeAllQualities": true,
  "includeMetadata":    true
}

Parameter	Type	Default	Description
tweetUrls	array or string	[]	Twitter/X tweet URLs or tweet IDs — supports both x.com and twitter.com links
videoOnly	boolean	false	When true, skips tweets that contain no video and only returns video records
includeAllQualities	boolean	true	When true, returns all available video quality URLs. When false, returns only the highest quality URL
includeMetadata	boolean	true	When true, includes full engagement metrics (likes, retweets, replies, views) in every record

Tip: Both x.com and twitter.com URLs are accepted interchangeably. Tweet IDs (numeric strings) are also accepted directly in the tweetUrls array.

---

📋 Output Fields

Every record from this Twitter Video Downloader includes complete Twitter video metadata in a fixed, consistent structure:

🐦 Tweet Fields

Field	Type	Description	Example
tweetId	string	Unique tweet ID	"1234567890123456789"
tweetUrl	string	Canonical X.com URL	"https://x.com/i/status/1234..."
status	string	Extraction status	"success"
mediaType	string	Content type detected	"video", "image"
text	string	Full tweet text / caption	"This is absolutely incredible 🔥"
displayText	string	Display title from tweet	"Watch this..."
createdAt	string	Tweet upload date (YYYYMMDD)	"20240315"
language	string	Detected tweet language	"en"
duration	string	Video duration (M:SS)	"1:24"
durationMs	integer	Duration in milliseconds	84000
aspectRatio	string	Video aspect ratio	"16:9"
thumbnail	string	Video thumbnail URL	"https://pbs.twimg.com/..."
quality	string	Best available quality label	"2176kbps"
downloadUrl	string	Best quality direct MP4 URL	"https://video.twimg.com/..."
timestamp	string	Extraction time (ISO 8601 UTC)	"2024-03-15T10:30:00Z"

👤 Author Object

Field	Type	Description	Example
author.name	string	Display name	"NASA"
author.username	string	Twitter/X handle	"NASA"
author.profileImage	string	Profile image URL	"https://pbs.twimg.com/..."

📈 Engagement Object (when includeMetadata: true)

Field	Type	Description	Example
engagement.likes	string	Formatted like count	"85.0K"
engagement.retweets	string	Formatted retweet count	"12.3K"
engagement.replies	string	Formatted reply count	"3.2K"
engagement.views	string	Formatted view count	"2.4M"

🎬 Video Qualities Array (when includeAllQualities: true)

Each entry in videoQualities contains a direct MP4 URL at a specific bitrate — sorted from highest to lowest quality:

[
  { "url": "https://video.twimg.com/.../720x1280.mp4", "bitrate": 2176000, "quality": "2176kbps", "contentType": "video/mp4" },
  { "url": "https://video.twimg.com/.../360x640.mp4",  "bitrate": 832000,  "quality": "832kbps",  "contentType": "video/mp4" },
  { "url": "https://video.twimg.com/.../240x426.mp4",  "bitrate": 256000,  "quality": "256kbps",  "contentType": "video/mp4" }
]

---

📦 Example Input & Output

Input:

{
  "tweetUrls": ["https://x.com/NASA/status/1234567890123456789"],
  "includeAllQualities": true,
  "includeMetadata": true
}

Output:

{
  "tweetId":     "1234567890123456789",
  "tweetUrl":    "https://x.com/i/status/1234567890123456789",
  "status":      "success",
  "mediaType":   "video",
  "text":        "Watch our latest launch highlights from Kennedy Space Center 🚀",
  "displayText": "NASA Launch Highlights",
  "createdAt":   "20240315",
  "language":    "en",
  "author": {
    "name":         "NASA",
    "username":     "NASA",
    "profileImage": "https://pbs.twimg.com/profile_images/..."
  },
  "engagement": {
    "likes":    "124.5K",
    "retweets": "38.2K",
    "replies":  "4.1K",
    "views":    "8.7M"
  },
  "thumbnail":   "https://pbs.twimg.com/ext_tw_video_thumb/.../img/thumb.jpg",
  "duration":    "1:24",
  "durationMs":  84000,
  "aspectRatio": "16:9",
  "quality":     "2176kbps",
  "downloadUrl": "https://video.twimg.com/ext_tw_video/.../720x1280.mp4",
  "videoQualities": [
    { "url": "https://video.twimg.com/.../720x1280.mp4", "bitrate": 2176000, "quality": "2176kbps", "contentType": "video/mp4" },
    { "url": "https://video.twimg.com/.../360x640.mp4",  "bitrate": 832000,  "quality": "832kbps",  "contentType": "video/mp4" }
  ],
  "timestamp": "2024-03-15T10:30:00Z"
}

---

💰 Pricing & Free Trial

Plan	Price	Includes
Free Trial	$0	2 hours full access — no credit card required
Monthly	$8.99 / month	Unlimited runs, bulk URLs, all quality levels

Everything included in every plan:

• ✅ All available video quality URLs — every bitrate in one record
• ✅ Complete Twitter video metadata — 15+ fields per tweet
• ✅ Engagement metrics: likes, retweets, replies, views
• ✅ Author profile: name, username, profile image
• ✅ videoOnly filter — skip non-video tweets automatically
• ✅ Supports both x.com and twitter.com URLs
• ✅ Bulk processing — any volume per run
• ✅ JSON + CSV + Excel export from Apify dataset
• ✅ Scheduled runs for automated X video monitoring

Start your 2-hour free trial now — no credit card needed. Click Try for free at the top of this page.

---

⚡ Performance & Limits

Mode	Count	Estimated Time
Single tweet video	1	~8–15 seconds
Small batch	10	~2–3 minutes
Medium batch	50	~8–15 minutes
Large batch	100	~18–30 minutes

• Results are pushed to the Apify dataset in real time as each tweet is processed
• Per-tweet error isolation — one failed tweet never stops the rest of the batch
• Non-video tweets are logged and skipped cleanly when videoOnly: true
• Duplicate tweet IDs in your input are removed automatically before processing

---

❓ FAQ

Q: Does this actor work with both twitter.com and x.com URLs? A: Yes. Both URL formats are accepted and processed identically. You can mix them freely in the same tweetUrls array.

Q: What is the difference between downloadUrl and videoQualities? A: downloadUrl always points to the highest available quality MP4 for quick use. videoQualities is the full array of all available bitrate options — useful when you need a specific file size or want to offer quality selection in your own application.

Q: Does this actor download video files to Apify's servers? A: No. The actor extracts and returns direct signed CDN URLs from Twitter's video hosting infrastructure. No files are stored on Apify. You use downloadUrl to download the video to your own system.

Q: How long are the video download URLs valid? A: Twitter/X CDN URLs are signed and expire within a few hours. Use them immediately after the run, or re-run the actor to refresh them.

Q: Can I use this X video downloader on private or protected accounts? A: No. Only publicly accessible tweets from public accounts are supported. Protected accounts and login-gated content are not supported.

Q: What does videoOnly: true do? A: When enabled, tweets that contain no video are automatically skipped and not included in the output. This is useful when your input list contains a mix of video and non-video tweet URLs.

Q: Can I get engagement metrics for every tweet? A: Yes. Set includeMetadata: true (the default) and every record will include the full engagement object with likes, retweets, replies, quotes, bookmarks, and views — all formatted for readability (e.g. "8.7M", "124.5K").

Q: Can I export results to Excel or CSV? A: Yes. All results are pushed to the Apify dataset, which can be exported to JSON, CSV, Excel, and more directly from the Apify Console after the run completes.

---

📜 Changelog

v2.0.0 (Current)

• ✅ All available video qualities returned — sorted by bitrate, highest first
• ✅ Complete Twitter video metadata: tweet text, display text, language, date, duration, aspect ratio
• ✅ Full engagement object: likes, retweets, replies, quotes, bookmarks, views
• ✅ Author profile object: name, username, profile image
• ✅ videoOnly filter — skip non-video tweets automatically
• ✅ includeAllQualities flag — control output size vs. completeness
• ✅ includeMetadata flag — toggle engagement data on/off
• ✅ Supports both x.com and twitter.com URL formats
• ✅ Tweet ID input accepted directly (no full URL required)
• ✅ Automatic duplicate tweet ID removal
• ✅ Per-tweet error isolation — batch never stops on a single failure
• ✅ Real-time dataset push as each tweet is processed

v1.0.0

• Initial release with basic Twitter video URL and tweet text extraction

---

🏷️ Tags

twitter video downloader x video downloader twitter video metadata tweet video download x.com video scraper twitter mp4 downloader tweet metadata scraper twitter engagement data x video extractor social media video downloader download video from twitter twitter data extraction

---

⚖️ Legal & Terms of Use

This actor extracts publicly accessible Twitter/X video metadata and CDN stream URLs in the same way a regular user views tweet content through a browser.

Please note:

• Use this tool only for personal backup, research, archiving, journalism, and education
• Only download content that you have the right to access and store
• Redistributing copyrighted Twitter/X video content without authorization may violate copyright law and X's Terms of Service
• Do not use this tool to scrape personal data, target private individuals, or facilitate harassment
• The actor developer is not responsible for how users choose to use the extracted content or metadata

---

🤝 Support & Feedback

• Bug report? Contact us via the Apify actor page
• Feature request? Post in the Apify Community forum
• Loving it? Please leave a ⭐ review — it helps other users find this actor!

---

Built with ❤️ on Apify
The most reliable Twitter Video Downloader — all quality levels, full X video metadata, no login required

💰 $9.99/month · 🆓 2-hour free trial · No credit card required