🐦 Twitter/X Profile Media Scraper

Extract all media tweets (photos & videos) from any Twitter/X profile with comprehensive metadata, engagement metrics, and high-quality media URLs. Perfect for content archiving, influencer research, social media analytics, and brand monitoring.

📋 Table of Contents

• ✨ Key Features
• 📊 Input Parameters
• 📤 Output Data Structure
• 💡 Usage Examples
• 🎯 Use Cases
• ❓ Frequently Asked Questions
• 🏷️ Tags

---

✨ Key Features

Feature	Description
📸 Media Extraction	Extract all photos and videos from any Twitter/X profile
🎬 Multiple Video Qualities	Get all video variants with different bitrates and resolutions
📊 Engagement Metrics	Views, likes, retweets, replies, quotes, and bookmarks
📊 User Profile Data	Followers, following, bio, website, and verification status
📊 High-Quality Media	Direct URLs to full-resolution images and videos
🔄 Pagination Support	Automatic pagination for large profiles
⚡ Fast & Reliable	Built-in retry logic and error handling
📱 Complete Metadata	Tweet text, timestamps, language, and source information

---

📊 Input Parameters

Parameter	Type	Required	Default	Description
screenName	String	✅ Yes	-	Twitter/X username without @ symbol (e.g., "KylieJenner")
maxPages	Integer	No	5	Maximum pages to fetch (1-100, ~10-20 tweets per page)

Username Format

• ✅ Valid: KylieJenner, elonmusk, NASA, cristiano
• ❌ Invalid: @KylieJenner, user-name, user.name, user name
• Must be 1-15 characters
• Only letters, numbers, and underscores allowed

---

📤 Output Data Structure

Each extracted tweet contains comprehensive information:

Tweet Information

Field	Type	Description
tweetId	String	Unique tweet identifier
conversationId	String	Conversation thread ID
tweetUrl	String	Direct link to the tweet
text	String	Tweet text content
language	String	Tweet language code
source	String	Platform used to post (e.g., "Twitter for iPhone")

Timestamps

Field	Type	Description
createdAt	String	Original timestamp string
timestamp	String	Formatted local timestamp
timestampISO	String	ISO 8601 formatted timestamp

Author Information

Field	Type	Description
authorId	String	Author's unique ID
authorName	String	Author's display name
screenName	String	Author's username/handle
authorAvatar	String	Profile picture URL
profileUrl	String	Link to author's profile
isBlueVerified	Boolean	Blue verification status

Engagement Metrics

Field	Type	Description
views	Integer	Number of views
favorites	Integer	Number of likes/favorites
retweets	Integer	Number of retweets
replies	Integer	Number of replies
quotes	Integer	Number of quote tweets
bookmarks	Integer	Number of bookmarks

Media Information

Field	Type	Description
mediaType	String	Media type: "Photo", "Video", or "Text"
hasPhotos	Boolean	Whether tweet contains photos
hasVideos	Boolean	Whether tweet contains videos
photoCount	Integer	Number of photos in tweet
videoCount	Integer	Number of videos in tweet
primaryImageUrl	String	URL of primary image/thumbnail
primaryVideoUrl	String	URL of highest quality video

Photos Array

Field	Type	Description
photos[].id	String	Photo media ID
photos[].url	String	Direct URL to full-resolution image

Videos Array

Field	Type	Description
videos[].id	String	Video media ID
videos[].thumbnailUrl	String	Video thumbnail image URL
videos[].videoUrl	String	Best quality video URL
videos[].bitrate	Integer	Video bitrate (higher = better quality)
videos[].duration	Integer	Video duration in milliseconds
videos[].width	Integer	Video width in pixels
videos[].height	Integer	Video height in pixels
videos[].aspectRatio	Array	Aspect ratio [width, height]
videos[].allVariants	Array	All available video quality variants

User Profile Statistics

Field	Type	Description
userFollowers	Integer	Number of followers
userFollowing	Integer	Number of following
userTweetsCount	Integer	Total tweets count
userMediaCount	Integer	Total media count
userWebsite	String	User's website URL
userLocation	String	User's location
userDescription	String	User's bio/description
userCreatedAt	String	Account creation date

---

💡 Usage Examples

Example 1: Basic Profile Media Scrape

Extract media from Kylie Jenner's profile:

{
  "screenName": "KylieJenner",
  "maxPages": 5
}

Example 2: Large Profile Archive

Archive all media from a profile (up to 100 pages):

{
  "screenName": "NASA",
  "maxPages": 100
}

Example 3: Quick Sample

Get just the first page of media:

{
  "screenName": "cristiano",
  "maxPages": 1
}

Example 4: Influencer Content Analysis

Analyze an influencer's media content:

{
  "screenName": "MrBeast",
  "maxPages": 20
}

Example 5: Brand Media Monitoring

Monitor a brand's visual content:

{
  "screenName": "Tesla",
  "maxPages": 10
}

---

🎯 Use Cases

📊 Content Archiving

• Personal Backup - Archive your own Twitter/X media content
• Portfolio Collection - Collect media from photographers and artists
• Historical Archive - Preserve important media content
• Media Library - Build a searchable media database

📊 Social Media Analytics

• Content Performance - Analyze which media gets most engagement
• Posting Patterns - Study posting frequency and timing
• Media Type Analysis - Compare photo vs video performance
• Engagement Trends - Track engagement metrics over time

🎨 Influencer Research

• Content Strategy - Study successful influencer content
• Media Quality - Analyze visual content quality
• Posting Frequency - Track how often influencers post media
• Engagement Rates - Calculate average engagement per post

💼 Brand Monitoring

• Competitor Analysis - Monitor competitor visual content
• Brand Consistency - Analyze brand visual identity
• Campaign Tracking - Track marketing campaign media
• User-Generated Content - Find media mentioning your brand

🎬 Video Content Research

• Video Quality Analysis - Access multiple video quality variants
• Thumbnail Research - Study effective video thumbnails
• Video Performance - Analyze video engagement metrics
• Content Ideas - Discover trending video content

---

❓ Frequently Asked Questions

General Questions

Q: What is Twitter/X Profile Media Scraper?
A: A powerful Apify actor that extracts all media tweets (photos and videos) from any Twitter/X profile with complete metadata, engagement metrics, and high-quality media URLs.

Q: How many tweets can I extract?
A: You can extract up to 100 pages per run, with approximately 10-20 media tweets per page (up to 2,000 tweets total).

Q: Is this scraper free to use?
A: The actor runs on Apify platform. You'll need an Apify account and will be charged based on platform usage (compute units).

Q: What data format does it output?
A: Data is exported in JSON, CSV, Excel, HTML, or XML format through Apify's dataset storage.

Media & Content

Q: What types of media are extracted?
A: Both photos and videos from tweets. The scraper extracts direct URLs to full-resolution images and multiple quality variants for videos.

Q: Can I get the highest quality videos?
A: Yes! The scraper extracts all available video quality variants and sorts them by bitrate, with the highest quality video URL provided in primaryVideoUrl.

Q: Are thumbnails included for videos?
A: Yes, video thumbnail URLs are included in the thumbnailUrl field for each video.

Q: What if a tweet has multiple photos or videos?
A: All photos and videos are extracted and stored in the photos and videos arrays with their respective URLs and metadata.

Technical Questions

Q: How long does it take to run?
A: Typically 1-5 minutes depending on the number of pages requested and profile size.

Q: What if the profile is private?
A: The scraper can only extract publicly available content. Private profiles cannot be scraped.

Q: Does it handle rate limits?
A: Yes, the actor has built-in retry logic and error handling to manage rate limits automatically.

Q: Can I schedule regular runs?
A: Yes, use Apify's scheduler feature to run the actor at specific intervals (hourly, daily, weekly).

Q: What if a username doesn't exist?
A: The actor will return an error if the username is not found or invalid.

Data & Export

Q: What file formats are supported?
A: JSON, CSV, Excel (XLSX), HTML, XML, and RSS feed formats.

Q: Can I integrate this with other tools?
A: Yes, use Apify's API or webhooks to integrate with your tools and workflows.

Q: How do I download the extracted data?
A: Data is automatically saved to Apify dataset. You can download it from the platform or access via API.

Q: Are the media URLs permanent?
A: The URLs are direct links to Twitter/X's CDN. They should remain accessible as long as the tweet exists.

---

🏷️ Tags

twitter scraper, x scraper, twitter media scraper, x media scraper, twitter photo scraper, twitter video scraper, x video downloader, twitter video downloader, twitter image downloader, x image scraper, twitter profile scraper, x profile scraper, twitter data extraction, x data scraper, social media scraper, twitter analytics, x analytics, twitter engagement metrics, x engagement scraper, influencer research tool, twitter content archiving, x media archiving, twitter backup tool, x backup scraper, brand monitoring tool, competitor analysis, social media analytics, twitter api scraper, x api alternative, download twitter videos, download twitter images, extract twitter media, scrape twitter photos, twitter media extractor, x media extractor, twitter content scraper, social media intelligence

---

🚀 Get Started Now

Ready to extract Twitter/X media content?

1. 👤 Enter the Twitter/X Username (e.g., KylieJenner)
2. 📄 Set the Max Pages (e.g., 5)
3. ▶️ Click Start to run the actor
4. 📥 Download your data in JSON, CSV, Excel, or HTML format
5. Click "Try for free" to test the actor

⭐ If this actor helps your workflow, please give it a star!

---

Related Actors 🤝

• Twitter X Video Downloader
• X Profile Viewer
• X Follower Scraper
• X Following Scraper
• Threads Search Scraper

---

Built with ❤️ by Sachin Kumar Yadav using Apify Platform