Instagram Auto Unfollow Actor

Automatically unfollow Instagram accounts with smart pacing to avoid action blocks. Uses session cookies for authentication (no password storage required!).

Features

✅ Cookie-Based Authentication: No need to store passwords - just paste your session cookie
✅ Smart Pacing: Configurable delays between unfollows with random variation to mimic human behavior
✅ Account Type Support: Different limits for new/high-activity accounts vs. mature accounts
✅ Rate Limit Detection: Automatically stops when Instagram rate limits are detected
✅ Human-like Behavior: Random browsing actions mixed in to appear more natural
✅ Session Management: Saves cookies for future runs
✅ Detailed Logging: Track every action and get a comprehensive summary
✅ Privacy-Focused: No personal data collection or external data transmission

How to Get Your Instagram Session Cookie

1. Open Instagram in your browser and log in

2. Open Developer Tools:

   • Chrome/Edge: Press F12 or Ctrl+Shift+I (Windows) / Cmd+Option+I (Mac)
   • Firefox: Press F12 or Ctrl+Shift+I (Windows) / Cmd+Option+I (Mac)
   • Safari: Enable Developer Menu in Preferences, then press Cmd+Option+I

3. Navigate to the Cookies section:

   • Chrome/Edge: Go to Application tab → Storage → Cookies → https://www.instagram.com
   • Firefox: Go to Storage tab → Cookies → https://www.instagram.com
   • Safari: Go to Storage tab → Cookies → https://www.instagram.com

4. Find the sessionid cookie and copy its value (long string of letters and numbers)

5. Paste it into the input when running the actor

⚠️ Important: Keep your session cookie private! It gives full access to your Instagram account.

Recommended Settings

New or High-Activity Accounts

• Max unfollows per day: 10-20
• Delay between unfollows: 45-60 seconds

Mature Accounts

• Max unfollows per day: 20-40
• Delay between unfollows: 30-45 seconds

Input Parameters

• sessionCookie (required): Your Instagram session cookie (sessionid value from browser cookies)
• usersToUnfollow (required): Array of Instagram usernames to unfollow
• maxUnfollowsPerRun (optional, default: 20): Maximum number of accounts to unfollow in this run
• delayBetweenUnfollows (optional, default: 45): Time to wait between each unfollow action in seconds
• randomDelayVariation (optional, default: 15): Random variation added to delays (±seconds)
• accountType (optional, default: mature): Either "new" (10-20/day) or "mature" (20-40/day)
• useCleanedInput (optional, default: false): Auto-uses cleaned input from previous run to skip already unfollowed accounts

Quick Start - Batch Processing

Want to unfollow 600 accounts but only do 20 at a time? Here's the easy way:

1. First Run:
   • Paste all 600 usernames in the input
   • Run the actor (will process first 20)
2. Subsequent Runs:
   • Check the "Use Cleaned Input from Previous Run" option ✓
   • Run again (will automatically process the next 20 from remaining 580)
   • Repeat until done!

The actor automatically tracks which accounts have been unfollowed and removes them from future runs.

Safety Tips

1. Start Slow: Begin with lower daily limits and gradually increase
2. Space Out Runs: Don't run the actor multiple times in quick succession
3. Mix Activities: Use your account normally between runs
4. Watch for Warnings: If you see "Try again later" messages, stop immediately and wait 24-48 hours
5. Schedule Runs: Run during your typical active hours to appear more natural

Output

The actor provides detailed results in the dataset with the following information:

Per-User Results

Each user gets an individual entry with:

• username: Instagram username
• status: One of success, skipped, or failed
• success: Boolean flag (true if status is success, false otherwise) - useful for filtering
• reason: Explanation (e.g., "Not following this user", "Rate limited", "Profile not found")
• timestamp: When the action was performed
• runDate: ISO timestamp of the run
• accountType: Account type used in settings

Summary Entry

A final summary entry includes:

• type: summary
• totalProcessed: Total users attempted
• unfollowedCount: Successfully unfollowed
• skippedCount: Users you weren't following
• failedCount: Failed attempts
• rateLimited: Whether rate limiting was encountered
• success: Boolean indicating overall run success (no rate limits and no failures)
• remainingUsers: Number of users still left to unfollow
• removedSuccessfully: Number of accounts removed from the list
• results: Complete array of all user results

Automated Input Cleaning

After each run, the actor automatically creates a cleaned input list that excludes all successfully unfollowed accounts. This is saved in the run's key-value storage as CLEANED_INPUT.

How to Use Cleaned Input

1. After your first run, check the logs for the "CLEANED INPUT FOR NEXT RUN" section
2. Copy the cleaned input JSON provided in the logs
3. Use it as your input for the next run
4. Repeat - This prevents re-processing already unfollowed accounts!

Example:

• Run 1: Unfollow first 10 → Creates cleaned list with remaining 40 accounts
• Run 2: Use cleaned input → Unfollow next 10 from the remaining 40
• Run 3: Use new cleaned input → Continue with remaining 30

This way, you can safely paste your entire unfollow list once and let the actor process it in batches!

Logs

The actor also prints detailed results in the logs:

📊 SUMMARY
==================================================
✅ Successfully unfollowed: 5
⏭️  Skipped (not following): 2
❌ Failed: 1
==================================================

📋 CLEANED INPUT FOR NEXT RUN
==================================================
✨ Cleaned input saved! Remaining users to process: 35
Successfully unfollowed accounts removed: 5
To use this for your next run, copy the following input:
{
  "sessionCookie": "...",
  "usersToUnfollow": ["user6", "user7", ...],
  "maxUnfollowsPerRun": 20,
  ...
}
==================================================

📋 DETAILED RESULTS:
==================================================
1. ✅ @username1

Status: success Timestamp: 2025-10-14T18:30:45.123Z

2. ⏭️ @username2 Status: skipped Reason: Not following this user Timestamp: 2025-10-14T18:31:30.456Z

3. ❌ @username3 Status: failed Reason: Profile not found Timestamp: 2025-10-14T18:32:15.789Z ==================================================

## Support & Issues

For issues or questions, please open an issue on the GitHub repository.

---

### Disclaimers

**Privacy & Data**: This actor does not collect, store, or transmit any personal information beyond what is necessary for operation within your Apify account. Your session cookie is stored securely in your private Apify storage and is never shared. [Privacy Policy](PRIVACY.md)

**Legal Notice**: This tool is for educational purposes only. The creator assumes no responsibility for account suspensions, restrictions, or violations of Instagram's Terms of Service. [Terms of Use](TERMS.md)

**Risk Acknowledgment**: Automated actions may violate Instagram's Terms of Service and may result in account restrictions. Use at your own risk and within reasonable limits.

**Detection Risk**: While this actor implements human-like behavior patterns, no automation tool is completely undetectable. Use responsibly.