BluesSky Followers Scraper

Extract comprehensive follower data from any BluesSky profile with pay-per-result pricing. Get detailed information including DID, handle, display name, avatar URL, creation date, and description for each follower.

✨ Features

• Pay-per-result pricing: Only pay for the followers you actually receive
• Clean data extraction: Get 6 essential data points per follower
• Pagination support: Automatically handles large follower lists
• Error handling: Robust error handling with detailed error reporting
• Rate limiting: Respectful API usage with built-in delays

📊 Output Data

Each follower record includes:

{
  "did": "did:plc:htvnybkdyoekkftxkyvcoiia",
  "handle": "nghidang.bsky.social", 
  "displayName": "nghidang.bsky.social",
  "avatar": "https://cdn.bsky.app/img/avatar/plain/...",
  "createdAt": "2024-02-06T19:00:35.147Z",
  "description": "User bio description"
}

🚀 Quick Start

Required Inputs

• Profile Handle: Target BluesSky profile to scrape (e.g., "forbes.com" or "username.bsky.social")

Optional Inputs

• Max Followers: Maximum number of followers to extract (default: 1000)

Example Configuration

{
  "profile_handle": "forbes.com",
  "max_followers": 1000
}

💰 Pricing

This actor uses pay-per-result pricing at $0.60 per 1000 followers extracted.

Cost Examples

• 100 followers = $0.06
• 500 followers = $0.30
• 1000 followers = $0.60
• 5000 followers = $3.00
• 10000 followers = $6.00

🔧 Advanced Usage

Custom Profile with Different Limit

{
  "profile_handle": "some-profile.bsky.social", 
  "max_followers": 500
}

Error Handling

The actor provides detailed error information when issues occur:

{
  "error": true,
  "error_type": "profile_not_found",
  "message": "Target profile doesn't exist."
}

Error types include:

• validation_error: Missing or invalid input parameters
• profile_not_found: Target profile doesn't exist
• no_results: Profile has no followers
• unexpected_error: System or network errors

📝 Use Cases

• Market Research: Analyze follower demographics of competitors
• Influencer Analysis: Study follower patterns of key accounts
• Lead Generation: Find potential customers from relevant profiles
• Social Media Analytics: Track follower growth and engagement
• Academic Research: Study social network patterns

⚠️ Important Notes

1. Data Accuracy: Follower data is scraped in real-time and reflects current state
2. Privacy: Use responsibly and respect user privacy
3. Terms of Service: Ensure your usage complies with BluesSky's terms

🛠️ Technical Details

• Runtime: Python 3.11 with asyncio for concurrent processing
• Dependencies: aiohttp for HTTP requests, apify SDK for data management
• Memory: 256MB RAM allocated for efficient performance
• Timeout: 1 hour maximum runtime per execution

📞 Support

If you encounter any issues or need help:

1. Check the error messages in the run log
2. Ensure the target profile handle is valid and exists
3. Verify the profile handle format (e.g., 'forbes.com' or 'username.bsky.social')
4. Contact support with your run ID for assistance

🔄 Updates

This actor is actively maintained with regular updates for:

• API compatibility
• Performance improvements
• New features and data points
• Bug fixes and stability improvements