📸 Instagram Followers & Following Scraper

Scrape Instagram followers and following lists with complete profile data. Extract usernames, follower counts, bios, verification status, business categories, and more from any Instagram profile.

✨ Features

• Flexible Input - Just enter usernames (e.g., natgeo) or full URLs
• Followers & Following - Scrape followers, following, or both
• Full Profile Enrichment - Optionally get complete profile data for each user (follower counts, bios, etc.)
• API Interception - Reliable data extraction via Instagram's internal APIs
• Smart Pagination - Automatically loads more users up to your limit
• Rate Limiting - Configurable delays to avoid detection
• Multiple Profiles - Process multiple accounts in one run

📊 What You Get

Basic Output (Fast)

Field	Description
username	Instagram username
user_id	Unique Instagram user ID
full_name	Display name
is_verified	Blue checkmark status
is_private	Private account status
profile_pic_url	Profile picture URL

With Full Profile Enrichment (Slower but more data)

Field	Description
follower_count	Number of followers
following_count	Number of following
media_count	Number of posts
biography	Profile bio text
external_url	Link in bio
is_business	Business/creator account
category	Business category (e.g., "Athlete", "Musician")

🚀 Quick Start

1. Get Your Instagram Cookies

You need to be logged into Instagram. Export cookies using a browser extension like:

• Cookie-Editor (Chrome/Firefox)
• EditThisCookie (Chrome)

Export as JSON format.

2. Configure Input

{
  "usernames": ["natgeo", "nasa", "instagram"],
  "scrapeType": "followers",
  "maxFollowersPerProfile": 100,
  "scrapeFullProfiles": false
}

3. Run & Export

Run the actor and export results as JSON, CSV, or Excel.

⚙️ Input Options

Field	Type	Default	Description
usernames	array	required	Instagram usernames or profile URLs
scrapeType	enum	followers	followers, following, or both
maxFollowersPerProfile	integer	100	Max users per profile (0 = unlimited)
scrapeFullProfiles	boolean	false	Navigate to each profile for complete data
cookies	string	-	Instagram cookies in JSON format
minDelayBetweenProfiles	integer	3	Min seconds between profiles
maxDelayBetweenProfiles	integer	7	Max seconds between profiles

📝 Example Output

{
  "username": "leomessi",
  "user_id": "427553890",
  "full_name": "Leo Messi",
  "is_verified": true,
  "is_private": false,
  "follower_count": 510281423,
  "following_count": 357,
  "media_count": 1443,
  "biography": "Bienvenidos a la cuenta oficial de Instagram de Leo Messi",
  "external_url": "http://apple.co/mlsmessi",
  "category": "Athlete",
  "profile_pic_url": "https://...",
  "profile_username": "natgeo",
  "scrape_type": "followers",
  "scraped_at": "2025-12-04T13:06:03.499460"
}

⚠️ Important Notes

1. Authentication Required - You must provide valid Instagram cookies to access follower lists
2. Rate Limits - Instagram limits how many users you can load per session (~100-200 per profile)
3. Full Profile Mode - Takes ~2-3 seconds per user but provides complete data
4. Private Accounts - You can only scrape followers of accounts you follow

🔧 Tips for Best Results

• Start with maxFollowersPerProfile: 50 to test
• Use scrapeFullProfiles: true only when you need detailed data
• Add delays between profiles to avoid rate limiting
• Keep your cookies fresh (re-export if scraping fails)

📄 License

MIT License - free for personal and commercial use.