X (Twitter) Video Downloader

Paste the link of a public X post with a video in it and you get the video as an MP4, or only its sound as an MP3. twitter.com links work the same way. Each file is saved in the run's key-value store, and its row in the dataset carries a direct download link.

You pay for the megabytes you receive. A link that fails, or a video over your size limit, is skipped and not billed per megabyte.

Input

{ "urls": ["https://x.com/historyinmemes/status/1790637656616943991"] }

Field	Default	What it does
urls	none	One link per line, each to a post (x.com/name/status/... or twitter.com/name/status/...).
quality	1080	best, 1080, 720, 480 or 360. The number is the short side of the picture, so 720 means 1280x720 for a landscape video and 720x1280 for a vertical one. If a video doesn't come in that quality, you get the closest one it has.
audioOnly	false	Only the video's sound, as a 128 kbit/s MP3.
maxMegabytes	500	Your limit per video. A bigger video is skipped before anything is downloaded.

A post with several videos gives you the first one. Pick another by ending the link with /video/2, /video/3 and so on.

This actor takes X links only. A TikTok or Facebook link is refused before anything is fetched, with a pointer to our TikTok Video Downloader or Facebook Video Downloader. YouTube links go in our YouTube Downloader.

What you get

One dataset row per delivered file:

{
  "url": "https://x.com/historyinmemes/status/1790637656616943991",
  "host": "x",
  "title": "Historic Vids - One of the most intense moments in history",
  "author": "Historic Vids",
  "durationSeconds": 15.56,
  "resolution": "728x720",
  "format": "mp4",
  "fileSizeBytes": 1404023,
  "billedMegabytes": 2,
  "mediaKey": "x-1790637589910654976.mp4",
  "mediaUrl": "https://api.apify.com/v2/key-value-stores/.../records/x-1790637589910654976.mp4"
}

The title is the account name followed by the post's text. resolution and durationSeconds are measured on the file you receive, not copied from the page. billedMegabytes is the file size rounded up to whole megabytes, where a megabyte is 1,000,000 bytes. X serves H.264 video with AAC sound, which every player opens.

Links that don't work out are listed in the ERRORS record of the same key-value store, each with a plain reason such as "This post is gone, or its video was removed." They never show up in the dataset. If not one link could be downloaded, the run ends as Failed instead of Succeeded, so a scheduled job or an integration notices.

Billing

Each delivered file is charged once, for its size in megabytes rounded up: the 1.4 MB clip above counts as 2 MB. The price per megabyte for your Apify plan is on the Pricing tab.

A link that fails, a video over your maxMegabytes, or one that doesn't fit the run costs nothing per megabyte. If you set a maximum charge for the run, the actor checks it before each download and skips a video it can't pay for rather than going over.

Big files

One run holds files up to about 70% of its memory, so 716 MB at the default 1024 MB. A bigger video is refused before it is downloaded, with a message that names the memory to use. A five-minute 720p video came to 18 MB in testing, so few X videos come close.

What it doesn't do

• Other sites. X only; see the links above for TikTok, Facebook and YouTube. Instagram and Vimeo are not supported by any of them.
• Protected accounts, or posts you have to sign in to see. There's no account and no cookies behind this.
• t.co short links. Open the post and paste its own x.com link instead.
• Photos and GIF-only posts without a video stream.
• Spaces, broadcasts and whole profiles. One link, one video.

Copyright

The videos belong to the people who posted them. Download only what you own or have permission to use, and stay within X's terms.

FAQ

Do I need an account, cookies or an API key? No. The link is the whole input.

Can I send lots of links in one run? Yes. They are downloaded one after another, and a short clip takes 5 to 10 seconds. The default run timeout is 30 minutes, so give a very big batch more.

Will a smaller memory setting save money? No. It doesn't change the price, and at 512 MB the same batch took about 75% longer in testing.

Where are the files? In the run's key-value store. mediaUrl in each row is a direct link, and mediaKey is the key if you'd rather fetch it through the API. How long the store is kept depends on your Apify plan, so download what you need.