POST /api/v1/x/media/download

Media

Changed on Oct 20, 2026

Downloads images and videos attached to selected tweets.

post/api/v1/x/media/download

Request

Base URL: https://xquik.com
URL: https://xquik.com/api/v1/x/media/download
Auth: one of:
- API key in header x-api-key
- HTTP bearer

Request body

tweetInputstring

Tweet URL or ID (single tweet)

tweetIdstring

Numeric tweet ID alias for tweetInput

tweetUrlstring

Tweet URL alias for tweetInput

tweetIdsstring[]

Up to 50 tweet URLs or IDs. An item that names no post gets 400 invalid_tweet_id, which says which item.

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. A single download returns tweetId, galleryUrl & cacheHit. A bulk download returns galleryUrl, totalTweets & totalMedia.

tweetIdstring

galleryUrlstring

cacheHitboolean

totalTweetsinteger

totalMediainteger

Example response

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

Changes

Oct 20, 202645942c75fdc2 Revision changes
- warning
  added the new topup_in_progress enum value to the ///// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status

Operation history