X Video Downloader

X Video Downloader (Twitter Video Downloader Actor)

Download Twitter (X) videos and photos in the best available quality and save structured data directly to your Apify dataset. This actor extracts direct MP4 links, thumbnails and rich Tweet metadata, so you can use the data in your own tools, dashboards or automations.

---

Table of Contents

1. Overview
2. Key Features
3. When to Use This Actor
4. Input Parameters
5. Output Data
6. How to Use on Apify
7. Examples
8. Best Practices
9. FAQ

---

Overview

This X Video Downloader actor helps you:

• Extract direct MP4 download URLs from public Tweets (X)
• Capture thumbnails, duration, aspect ratio and all available video qualities
• Save photos from image-only Tweets
• Store clean, structured metadata (author info, engagement, timestamps) in an Apify dataset

You can then easily export everything to JSON, CSV or Excel and plug it into your own workflows.

---

Key Features

• Accepts Tweet IDs as input (simple, fast)
• Detects all video qualities and marks the best quality for download
• Supports photo tweets (downloads image URLs)
• Rich Tweet metadata: author, followers, language, engagement and more
• One item per Tweet in the dataset with a clear schema

---

When to Use This Actor

• Build a Twitter (X) video download pipeline for your internal tools
• Create video datasets for analysis, reporting or content curation
• Track campaigns, influencers or brands based on their video posts
• Archive public video content from X for research or auditing

---

Input Parameters

Your input lives in the actor's INPUT store and is controlled by the Apify UI form.

Field	Type	Required	Description
tweetId	array of strings	Yes	List of Tweet IDs. The actor internally extracts and validates numeric Tweet IDs.

Minimum 1 item and maximum 10 items per run.

---

Output Data

Each dataset item represents one Tweet and summarises all detected media and metadata.

Field	Type	Description
tweetId	string	Tweet ID.
tweetUrl	string	Public Tweet URL.
status	string	success, failed or no_media.
mediaType	string	video, photo or mixed.
text	string	Raw Tweet text.
displayText	string	Cleaned text with readable URLs.
createdAt	string	Tweet creation time.
language	string	Language code (for example en).
author	object	Author details (name, username, profile image, verified, followers).
engagement	object	Formatted likes, retweets, replies, quotes, bookmarks and views.
likesCount	number	Raw like count.
retweetsCount	number	Raw retweet count.
viewsCount	number	Raw view count.
thumbnail	string	Main media thumbnail URL.
downloadUrl	string	Primary download URL (best quality video or first photo).
duration	string	Video duration in MM:SS format.
durationMs	number	Video duration in milliseconds.
aspectRatio	string	Video aspect ratio, e.g. 16:9.
video	object	Detailed video info including downloadUrl, quality, qualities[].
video.qualities[]	array	All available MP4 variants with bitrate and URLs.
photos[]	array	List of photo objects with direct image URLs.
timestamp	string	Timestamp when the actor processed the Tweet.

You can view the full schema in the Output schema tab on Apify or by inspecting a sample dataset item after a run.

---

How to Use on Apify

1. Open the actor on Apify.
2. Click Run.
3. In the input form, paste Tweet IDs (or Tweet URLs that contain video or photos).
4. Start the run.
5. When the run finishes, open the Dataset tab to see the results.
6. Export the dataset as JSON, CSV or Excel for further use.

---

Examples

Example 1 – Basic run with Tweet IDs

{
  "tweetUrls": [
    "1986587629740270045",
    "1732824684683784516"
  ]
}

---

Best Practices

• Use valid public Tweets only – private or protected Tweets cannot be processed.
• Prefer Tweet IDs instead of full URLs for cleaner input.
• If you need more than 10 items per run, fork the actor and adjust limits.
• Download or process dataset results soon after the run, as some media URLs may expire over time.

---

FAQ

Q: Does this actor store video files in Apify storage?
A: No. The actor outputs direct download URLs and metadata. You can download the files later using your own tools or automations.

Q: Why do some Tweets return no_media?
A: The Tweet may not contain any video or photo, or the media may be restricted, deleted or not publicly available.

Q: Will I always get 1080p or 4K quality?
A: The actor picks the highest available MP4 bitrate provided by X. Actual resolution depends on what was uploaded originally.

Q: Can I use this actor for protected or private accounts?
A: No. The actor only works with public Tweets that anyone can open without logging in.

Q: What is the difference between text and displayText?
A: text contains the raw Tweet body including short links. displayText is a cleaned version with expanded URLs, better for reading and exporting.

Q: How many Tweets can I process?
A: By default the actor is optimised for small batches. For large‑scale usage, create a custom workflow or fork the actor and tune limits and concurrency.

---

Tags

These keywords describe what the actor does and help users discover it on Apify and search engines:

• x video downloader
• twitter video downloader actor
• download twitter videos mp4
• x.com video download
• twitter video scraper
• twitter video metadata extractor
• twitter to mp4 dataset
• apify twitter video downloader
• download x videos with metadata
• twitter video dataset export

---

If this actor is useful in your workflow, please leave a rating or star on Apify so others can discover it.