Twitter (X) Video Downloader

Twitter (X) Video Downloader⚡

Easily extract downloadable MP4 links and rich metadata from public Tweets (X). Provide Tweet URLs or IDs, and this actor will parse media variants, choose the best-quality MP4, and save structured results to your Apify dataset. No hassle, just clean and reliable output.

---

Table of Contents 📚

1. Highlights
2. Use Cases
3. Input Parameters
4. Quick Start
5. Examples
6. Output Schema
7. Best Practices
8. FAQ
9. Related actor

---

Highlights ✨

• 🎯 Accepts Tweet URLs or raw Tweet IDs (batch-friendly)
• 🎥 Detects media variants and picks the highest-bitrate MP4 automatically
• 🔁 Optional inclusion of HLS (m3u8) URL
• 📦 One dataset item per media with Tweet and user context
• 🧱 Built with Apify best practices (structured output and robust error handling)

---

Use Cases 💡

• Social media content research and curation
• Tracking brand/influencer video posts
• Archiving and media analysis workflows
• Building datasets of MP4 links for further processing

---

Input Parameters 🧰

Field	Type	Required	Description
tweetUrls	array	Optional	List of Tweet status URLs from x.com or twitter.com. Editor: requestListSources.
tweetIds	array	Optional	Raw Tweet IDs. Can be combined with tweetUrls. Editor: stringList.
includeHls	boolean	Optional (default false)	Include HLS (m3u8) variant in output.
preferBestQuality	boolean	Optional (default true)	Select highest bitrate MP4 as best_video_url.

---

Quick Start 🚀

1. Open the actor on Apify and click Run.
2. Add Tweet URLs or Tweet IDs in the input.
3. Start the run. One dataset item per media will be created with the selected best-quality MP4.
4. Download your results from the Dataset in JSON/CSV/Excel.

---

Examples 📎

Input (URLs):

{
  "tweetUrls": [
    { "url": "https://x.com/SpaceX/status/1732824684683784516" }
  ],
  "includeHls": false,
  "preferBestQuality": true
}

Input (IDs):

{
  "tweetIds": [
    "1293593516040269825",
    "1732824684683784516"
  ],
  "includeHls": true
}

---

Output Schema 🧾

Each dataset item represents one video or animated_gif media inside a Tweet.

Path	Type	Description
success	boolean	Whether the media item was extracted successfully
tweet_id	string	Tweet ID
text	string	Tweet text
user.id_str	string	User ID
user.screen_name	string	Username (handle)
user.name	string	Display name
user.profile_image_url_https	string	User profile image URL
media_key	string	Media key for the asset
media_type	string	video or animated_gif
thumbnail_url	string	Thumbnail image URL
aspect_ratio	array	Aspect ratio [w, h]
duration_millis	number	Media duration in ms
variants[]	array	List of available media variants (MP4 and optional HLS)
best_video_url	string	Highest-bitrate MP4 URL
hls_url	string or null	HLS streaming URL (if included)
fetched_at	string	ISO timestamp when the data was captured

Output example (single item):

{
  "success": true,
  "tweet_id": "1732824684683784516",
  "text": "At dawn from the gateway to Mars, the launch of Starship’s second flight test ...",
  "user": {
    "id_str": "34743251",
    "screen_name": "SpaceX",
    "name": "SpaceX",
    "profile_image_url_https": "https://pbs.twimg.com/profile_images/.../normal.jpg"
  },
  "media_key": "7_1732820284301058052",
  "media_type": "video",
  "thumbnail_url": "https://pbs.twimg.com/ext_tw_video_thumb/.../pu/img/..jpg",
  "aspect_ratio": [16, 9],
  "duration_millis": 114322,
  "variants": [
    { "content_type": "video/mp4", "bitrate": 256000, "url": "https://video.twimg.com/...480x270...mp4" },
    { "content_type": "video/mp4", "bitrate": 832000, "url": "https://video.twimg.com/...640x360...mp4" },
    { "content_type": "video/mp4", "bitrate": 2176000, "url": "https://video.twimg.com/...1280x720...mp4" }
  ],
  "best_video_url": "https://video.twimg.com/...1920x1080...mp4",
  "hls_url": null,
  "fetched_at": "2025-11-02T07:59:14.000Z"
}

---

Best Practices ✅

• Provide valid public Tweet URLs that contain video.
• Export dataset results in your preferred format (JSON, CSV, Excel) from the Apify UI.
• Process results promptly; some media URLs can expire.

---

FAQ ❓

Does this actor download video files to storage?
No. It outputs direct video URLs and metadata. You can download files using your own tooling.

Why do some Tweets return no results?
The Tweet might not contain video media, the media may be restricted, or it may have been removed.

Will the best-quality link always be 1080p?
Not guaranteed. The actor selects the highest available bitrate among MP4 variants.

Related actor

• Twitter User Data Scraper (profiles): https://apify.com/igview-owner/x-twitter-profile-viewer

---

Support 🙌

If you need help, feature requests, or a custom workflow, open an issue in your tracker or contact the actor author.

---

Find Me Better 🔎

twitter video downloader, x video downloader, twitter mp4 extractor, download twitter videos mp4, tweet video url, apify twitter actor, social media video downloader, x.com video download, twitter dataset export, scrape twitter video metadata