X (Twitter) Media Downloader avatar
X (Twitter) Media Downloader

Pricing

from $4.00 / 1,000 results

Go to Apify Store
X (Twitter) Media Downloader

X (Twitter) Media Downloader

Download high-quality images, videos, and GIFs from X/Twitter — including tweets, replies, quote tweets, threads, and public profiles.

Pricing

from $4.00 / 1,000 results

Rating

0.0

(0)

Developer

mikolabs

mikolabs

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Share

X (Twitter) Media Downloader

Download high-quality X (Twitter) images, videos, and GIFs from tweets, replies, and public profiles.

This Apify Actor extracts original-quality media along with tweet metadata including text, engagement statistics, and dates. It supports tweets, quote tweets, replies, threads, and entire public profiles.

No login required. Public content only.


Features

  • Extracts original-resolution images (no compression)
  • Downloads the highest available video quality
  • Saves animated GIFs in original format
  • Collects tweet metadata (stats, author info, timestamps)
  • Supports profile media tab scraping
  • Automatic retries, proxy rotation, and queue optimization included

When to Use This Actor

Use CaseBenefit
Content archivalPreserve high-quality media
Social media researchAnalyze viral trends and media patterns
ML dataset creationCollect visual assets for AI and ML pipelines
Competitor monitoringTrack engagement performance
Media curationBuild collections of trending posts

Input Parameters

FieldTypeOptionalDefaultDescription
tweetUrlsarray(string)Yes[]Tweet URLs or IDs
extractMainTweetbooleanYestrueExtract media from main tweet
extractRepliesMediabooleanYesfalseExtract media from replies
maxRepliesintegerYes10Max replies to scrape (1–100)
twitterHandlesarray(string)Yes[]Profile usernames (without @)
extractProfileMediabooleanYesfalseScrape media tab on profiles
profileMediaMaxItemsintegerYes10Max media items per profile (1–1000)
mediaTypeFilterstringYesallFilter: all, images, videos, gifs
includeImagesbooleanYestrueInclude images
includeVideosbooleanYestrueInclude videos
includeGifsbooleanYestrueInclude GIFs
includeAllQualityVersionsbooleanYesfalseInclude all video qualities
minLikesintegerYes0Minimum likes filter
minRetweetsintegerYes0Minimum retweets filter
minRepliesintegerYes0Minimum replies filter
onlyVerifiedbooleanYesfalseFilter for verified users
tweetLanguagestringYes""Filter by language code (en, es, etc.)
includeTweetMetadatabooleanYestrueInclude metadata (text, stats, date)
proxyConfigurationobjectYesAutoRecommended: residential proxies

Minimal JSON Example

{
"tweetUrls": ["https://x.com/example/status/123"]
}

Output Format

Each scraped item includes:

FieldDescription
item_typetweet_media, reply_media, or profile_media
tweet_urlOriginal tweet URL
tweet_idUnique ID
usernameTweet author
profile_usernameTarget user (if profile media)
fullnameDisplay name
textTweet text
datePost timestamp
statsLikes, retweets, replies, views
mediaArray of objects with type and download URLs
scrape_dateTimestamp of scraping activity

Output Example

{
"item_type": "tweet_media",
"tweet_url": "https://x.com/example/status/123",
"username": "elonmusk",
"media": [
{
"type": "image",
"url": "https://pbs.twimg.com/media/example.jpg"
}
],
"stats": {
"likes": 532000,
"retweets": 98000
}
}

Proxy Recommendations

Use CaseSuggested Proxy Type
Single tweet scrapingShared/automatic
Profile media scrapingResidential proxies

Residential proxies help reduce temporary rate limits.


Performance Tips

SettingOptimized For
maxReplies = 50–100Deep media extraction
profileMediaMaxItems > 200Large dataset collection
disable metadataFaster execution

Running the Actor

CLI

$apify run x-media-downloader --input=input.json

JavaScript API

await client.actor("x-media-downloader").call({
tweetUrls: ["https://x.com/example/status/123"]
});

Frequently Asked Questions

QuestionAnswer
Supports private accounts?No (public only)
Requires login?No
Supports threads?Yes (when reply scraping enabled)
Multiple profiles per run?Yes

This Actor only accesses publicly viewable content. Users must comply with X/Twitter Terms of Service and applicable copyright laws.


Support

Need additional features such as hashtag scraping, automated downloading to storage, ML dataset export, or custom filters?

Contact through Apify for enhancements and support.


Feedback

If this Actor is helpful, please consider leaving a rating on Apify.