Video Download API
Social Media

Twitter / X Video Download API

Download videos embedded in tweets from Twitter/X. Support for GIFs, video tweets, and Spaces audio content.

MP4GIFMP3
Get API accessView all platforms

Supported Features

  • Video tweets
  • GIF downloads
  • Multiple video qualities
  • Twitter Spaces audio
  • Thread videos
  • Embedded media

Quick start example

Download Twitter / X videos with a simple API call. Here's how to get started:

download-twitter-video.sh
curl --request GET \
  --url 'https://api.endpoint-hidden-contact-us.com/v1/video/download?query=https://twitter.com/user/status/123' \
  --header 'x-api-key: YOUR_API_KEY'
Response200 OK
{
  "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Use the job_id to check the download status via the Jobs endpoint.

Job completed response

What you get when the download is ready

Once the job completes, retrieve the full response using the job_id. Here's an example of a completed Twitter / X video download:

GET /api/jobs/{job_id}
curl -X GET "https://api.endpoint-hidden-contact-us.com/v1/jobs/019b550b-da47-4d31-b764-242dfb16944e" \
  -H "Authorization: Bearer YOUR_API_KEY"
Completed Job Response200 OK
{
  "id": "019b550b-da47-4d31-b764-242dfb16944e",
  "success": true,
  "status": "CompletedJob",
  "endpoint": "/api/video/download",
  "created_at": "2025-12-25T10:26:38.790691Z",
  "started_at": "2025-12-25T10:26:38.794956Z",
  "duration_ms": 19677,
  "args": {
    "query": "https://www.twitter.com/video/example",
    "video_format": "mp4",
    "download_type": "video",
    "video_quality": "best",
    "async": false
  },
  "result": {
    "metadata": {
      "title": "Example Twitter / X Video Title",
      "duration": 127,
      "thumbnail": "https://example.com/thumbnail.jpg",
      "resolution": "1920x1080",
      "view_count": 125430,
      "like_count": 8542,
      "channel_id": "xxxxxx",
      "description": "Video description from Twitter / X...",
      "upload_date": 1760832000
    },
    "response": "https://s3.domain.com/videos/00b2b9fb-0d26-468b-8c14-d07c22161992.mp4"
  }
}

result.response

Direct S3 URL to download the processed video file. Cached and ready for immediate access.

result.metadata

Rich metadata including title, duration, thumbnails, view counts, and more.

duration_ms

Processing time in milliseconds. Most jobs complete in under 30 seconds.

status

Job status: PendingJob, RunningJob, or CompletedJob.

Why use our Twitter / X video download API

Built for reliability, speed, and ease of integration

Live processing

Real-time extraction of Twitter / X videos with async job tracking

High reliability

99.9% uptime with automatic failover and error handling

Multiple formats

Support for MP4, GIF, MP3 with quality options

Related platforms

Instagram

Reels, posts, and video content from public profiles

TikTok

Short-form videos with or without watermark

Facebook

Public video posts and reels

Start downloading Twitter / X videos today

Get your API key and start integrating our Twitter / X video download API into your application.

Get API accessView all platforms