Download public Twitter / X video posts with one API call: MP4 video up to the best available quality, or just the audio as MP3, M4A or WAV. Title, channel, duration and thumbnail come with every response.
Free: read the title, channel and duration before you download, and see what it will cost. This is the real response for this link.
curl -G "https://videodownloadapi.com/api/v1/media" \ --data-urlencode "url=https://x.com/SpaceX/status/1732824684683784516" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"title": "SpaceX - At dawn from the gateway to Mars, the launch of Starship’s second fli...",
"channel": "SpaceX",
"platform": "Twitter",
"thumbnail": "https://…",
"duration_seconds": 114,
"minutes_required": 2
}The API answers right away with HTTP 202 and a download_id; the file is prepared in the background.
curl -X POST "https://videodownloadapi.com/api/v1/downloads" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://x.com/SpaceX/status/1732824684683784516", "format": "mp4"}'{
"download_id": "162b76ab-833e-4720-b687-dac284d479aa",
"title": "SpaceX - At dawn from the gateway to Mars, the launch of Starship’s second fli...",
"platform": "Twitter",
"duration_seconds": 114,
"format": "mp4",
"quality": "best",
"status": "processing",
"progress": 0,
"minutes": 2,
"expires_at": null
}Poll the download every few seconds. When the status is ready, the response includes the file link.
curl "https://videodownloadapi.com/api/v1/downloads/162b76ab-833e-4720-b687-dac284d479aa" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"download_id": "162b76ab-833e-4720-b687-dac284d479aa",
"title": "SpaceX - At dawn from the gateway to Mars, the launch of Starship’s second fli...",
"platform": "Twitter",
"duration_seconds": 114,
"format": "mp4",
"quality": "best",
"status": "ready",
"progress": 100,
"minutes": 2,
"expires_at": "2026-11-04T10:30:46.678Z",
"download_url": "https://videodownloadapi.com/api/downloads/162b76ab-833e-4720-b687-dac284d479aa?token=…"
}status, progressprocessing, then storing, then ready (or failed). progress goes from 0 to 100.
download_urlSigned link to the file, valid for 1 hour. Ask for the download again to get a fresh one while the file is kept (48 hours).
title, platform, duration_secondsRead from the link before the download starts, with format and quality.
minutesDownloads are billed per started minute of media: a 61-second video uses 2 minutes. Charged when the job starts, refunded automatically if it fails.
The same API for every platform, with predictable costs
Start a download, follow its progress, get a link: long videos never time out
Private, deleted or unreadable videos cost nothing: the minutes come back
MP4 up to the best available quality, or MP3, M4A and WAV audio
Get your API key and start integrating our Twitter / X video download API into your application.