🐦 Twitter X Follower Scraper

Unlock the Power of Social Intelligence - Extract comprehensive follower data from any Twitter X account with unprecedented precision and speed.

---

📋 Table of Contents

• 🚀 Quick Start
• ✨ Key Features
• 🎯 Use Cases
• 📊 Data Output
• ⚙️ Configuration
• 💡 Pro Tips
• 🔧 API Integration
• 📈 Performance
• ❓ FAQ
• 🆘 Support

---

🚀 Quick Start

Transform your social media strategy in 3 simple steps:

1. Add Target Usernames - Enter Twitter X usernames you want to analyze
2. Configure Settings - Set follower limits and verification filters
3. Extract & Analyze - Get comprehensive follower data instantly

import { ApifyApi } from 'apify-client';

const client = new ApifyApi({
    token: '<YOUR_API_TOKEN>',
});

const input = {
    usernames: ['elonmusk', 'rihanna'],
    max_followers_per_user: 1000,
    blue_verified_only: false
};

const run = await client.actor("your-username/twitter-x-follower-scraper").call(input);
console.log(run.defaultDatasetItems);

---

✨ Key Features

🎯 Precision Targeting

• Extract followers from any public Twitter X account
• Support for multiple username formats (@username, username, full URLs)
• Batch processing for multiple accounts simultaneously

📊 Rich Data Collection

• Profile Information: Names, bios, profile images, locations
• Engagement Metrics: Followers, following, tweets, media counts
• Verification Status: Twitter Blue and legacy verification badges
• Account Details: Creation dates, business accounts, affiliates

⚡ Enterprise Performance

• High-Speed Processing: Extract thousands of followers per minute
• Smart Rate Limiting: Automatic request throttling to avoid blocks
• Robust Error Handling: Continues processing even if some accounts fail
• Scalable Architecture: Handle multiple API keys for increased throughput

🔒 Reliability & Compliance

• Real-time Data: Always fresh, up-to-date follower information
• Error Recovery: Automatic retries and failover mechanisms
• Data Integrity: Comprehensive validation and cleaning

---

🎯 Use Cases

Use Case	Description	Benefits
🎯 Influencer Marketing	Analyze influencer audiences for campaign targeting	Higher ROI, better audience match
📈 Market Research	Study competitor followers and market segments	Competitive advantage, market insights
🔍 Lead Generation	Find potential customers through follower analysis	Quality leads, targeted outreach
📊 Social Analytics	Track follower growth and audience demographics	Data-driven decisions, growth optimization
🎪 Brand Monitoring	Monitor who follows your brand and competitors	Brand awareness, reputation management
🚀 Growth Hacking	Identify high-value accounts to follow/engage	Organic growth, community building

---

📊 Data Output

Each follower record contains comprehensive information:

👤 Profile Data

{
  "user_id": "1234567890",
  "screen_name": "example_user",
  "name": "Example User",
  "description": "Digital marketing expert 🚀",
  "profile_image": "https://pbs.twimg.com/profile_images/...",
  "location": "San Francisco, CA",
  "website": "https://example.com"
}

📈 Engagement Metrics

{
  "statuses_count": 1250,
  "followers_count": 5420,
  "friends_count": 890,
  "media_count": 156
}

✅ Verification & Status

{
  "blue_verified": true,
  "verified": false,
  "can_dm": true,
  "business_account": null,
  "created_at": "Wed Mar 15 12:30:45 +0000 2023"
}

---

⚙️ Configuration

🎛️ Input Parameters

Parameter	Type	Required	Description
usernames	Array	✅	Twitter X usernames to extract followers from
max_followers_per_user	Integer	❌	Maximum followers per user (default: 1000)
blue_verified_only	Boolean	❌	Extract only Twitter Blue verified followers

🔧 Advanced Settings

{
  "usernames": ["elonmusk", "rihanna", "@sundarpichai"],
  "max_followers_per_user": 5000,
  "blue_verified_only": false
}

Username Format Support:

• ✅ username - Simple username
• ✅ @username - With @ symbol
• ✅ https://twitter.com/username - Full Twitter URL
• ✅ https://x.com/username - X.com URL

---

💡 Pro Tips

🚀 Maximize Performance

• Batch Processing: Add multiple usernames to process them efficiently
• Optimal Limits: Use 1000-5000 followers per user for best speed/data balance

🎯 Data Quality

• Blue Verified Filter: Enable for higher quality, more engaged followers
• Regular Updates: Run extractions regularly to track follower changes
• Data Validation: Always validate extracted data before analysis

📊 Analysis Strategies

• Audience Overlap: Compare followers across different accounts
• Engagement Patterns: Analyze follower activity and engagement levels
• Growth Tracking: Monitor follower acquisition over time

---

📈 Performance

⚡ Speed Benchmarks

Followers	Processing Time	API Requests
1,000	~2-3 minutes	10-15 requests
5,000	~8-12 minutes	50-75 requests
10,000	~15-25 minutes	100-150 requests

🔄 Rate Limiting

• Smart Throttling: Automatic delays between requests
• Error Recovery: Automatic retries on temporary failures

---

❓ FAQ

Q: How many followers can I extract?

A: You can extract up to 50,000 followers per username. For optimal performance, we recommend 1,000-5,000 followers per run.

Q: What data do I get for each follower?

A: Complete profile information including username, display name, bio, follower counts, verification status, profile image, location, and more.

Q: Can I extract followers from private accounts?

A: No, the scraper only works with public Twitter X accounts due to API limitations.

Q: How often should I run the scraper?

A: For active monitoring, run weekly or monthly. For one-time analysis, a single run is sufficient.

Q: Is the data real-time?

A: Yes, all data is fetched in real-time directly from Twitter X's API.

Q: What happens if an account is suspended or deleted?

A: The scraper will skip unavailable accounts and continue processing others, logging any errors.

Q: Can I filter followers by specific criteria?

A: Yes, you can filter by Twitter Blue verification status. More filters may be added in future updates.

Q: How do I handle large datasets?

A: Use Apify's dataset API to process data in chunks, or export to CSV/JSON for external analysis.

---

🆘 Support

📞 Get Help

• 📧 Email Support: Contact us for technical assistance
• 📚 Documentation: Comprehensive guides and examples
• 💬 Community: Join our developer community
• 🐛 Bug Reports: Report issues for quick resolution

🔄 Updates & Maintenance

• ✅ Regular updates for API changes
• 🛡️ Security patches and improvements
• 📈 Performance optimizations
• 🆕 New features based on user feedback

---

Ready to unlock the power of Twitter X follower data? 🚀

Start your social intelligence journey today and transform how you understand and engage with your audience!

---

Built with ❤️ for the Apify community