X (Twitter) Media Scraper & Downloader

Download photos, videos, and GIFs from X (Twitter) tweets and profiles — no login, no cookies, no browser.

Extract every photo, native video, and animated GIF from individual tweet URLs or bulk-scrape a profile's recent media timeline. Provider-backed via ScrapeCreators + SociaVault for high reliability. MCP-ready for AI-agent workflows.

---

What You Get

Field	Description	Example
tweetUrl	Full tweet URL	https://x.com/NASA/status/1895...
tweetId	Tweet ID string	"1895937985895723209"
author	Display name	"NASA"
authorHandle	@handle	"NASA"
tweetText	Full tweet text	"Mars rover captures..."
tweetDate	Posting date	"Mon Aug 19 12:00:00 +0000 2026"
likeCount	Total likes	42381
retweetCount	Retweets	5219
replyCount	Replies	873
viewCount	View count	1200000
mediaType	photo, video, or animated_gif	"video"
mediaUrl	Direct download URL	https://video.twimg.com/...mp4
thumbnailUrl	Thumbnail/cover image URL	https://pbs.twimg.com/...jpg
durationMs	Video duration in milliseconds	31533
width	Media width px	1280
height	Media height px	720
bitrate	Video bitrate (highest-quality variant selected)	2176000
mediaIndex	Media position within the tweet (0-based)	0
kvKey	Key-value store key when saveToKeyValueStore=true	"1895_0.mp4"

---

Use Cases

• Content archiving — back up a creator's entire photo/video library
• Brand monitoring — collect all media from competitor accounts
• Research — build annotated media datasets from public tweets
• Journalism — archive source media from news events before deletion
• AI training — gather labeled image/video datasets from topic accounts

---

How to Use

Single tweet — grab all media

{
  "tweetUrls": ["https://x.com/NASA/status/1895937985895723209"]
}

Bulk profile media

{
  "handles": ["NASA", "SpaceX"],
  "maxTweetsPerHandle": 50,
  "mediaTypes": ["photo", "video"]
}

Download files to storage

{
  "tweetUrls": ["https://x.com/NASA/status/1895937985895723209"],
  "saveToKeyValueStore": true
}

---

Pricing

Pay per event — you only pay for results.

Event	Price
Actor start	$0.00005
Per media item found	$0.005

Typical cost: 100 media items = $0.50. A profile with 50 tweet-media posts containing 2–3 images each ≈ 100–150 items ≈ $0.50–$0.75.

---

API Example

curl -X POST https://api.apify.com/v2/acts/khadinakbar~x-media-scraper/runs \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -d '{"tweetUrls":["https://x.com/NASA/status/1895937985895723209"]}'

---

Technical Notes

• Provider-backed: ScrapeCreators primary → SociaVault fallback. No X login or cookies needed.
• Best-quality video: automatically selects the highest-bitrate MP4 variant.
• Photo format: returns ?format=jpg&name=large (original resolution) with name=thumb for previews.
• GIFs: animated_gif type returns the looping MP4 used by X internally.
• No liker/follower data: only media from tweet content; follower lists and like identities are not scraped.

---

Legal Disclaimer

This tool accesses publicly available X (Twitter) data. Use in compliance with X's Terms of Service and applicable laws. Do not use for harassment, copyright infringement, or surveillance purposes. The actor operator is not responsible for how scraped data is used.

---

Related Actors

• X Tweet Scraper — full tweet metadata, search, hashtags
• Twitter Profile & Followers Scraper — follower lists and profile data
• Instagram Post Engagers Scraper — Instagram media + engagers