v11

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112893437.0 KB

Media

Download images and videos from tweets

post/x/media/download

Request body

tweetInputstring

Tweet URL or ID (single tweet)

tweetIdstring

Numeric tweet ID alias for tweetInput

tweetUrlstring

Tweet URL alias for tweetInput

tweetIdsstring[]

Array of tweet URLs or IDs (bulk, max 50 string items)

Example request

{
  "tweetInput": "https://x.com/elonmusk/status/1234567890",
  "tweetId": "1234567890",
  "tweetUrl": "https://x.com/elonmusk/status/1234567890",
  "tweetIds": [
    "1234567890",
    "1234567891"
  ]
}

Response

Media download result. Single: tweetId + galleryUrl + cacheHit. Bulk: galleryUrl + totalTweets + totalMedia.

tweetIdstring

galleryUrlstring

cacheHitboolean

totalTweetsinteger

totalMediainteger

Example response

{
  "tweetId": "1234567890",
  "galleryUrl": "https://xquik.com/gallery/abc123",
  "totalTweets": 2,
  "totalMedia": 5
}