Instagram Bulk DM - Simplified Single Account Version

Send direct messages to multiple Instagram users from a single account using cookies or session ID.

🎯 Features

• ✅ Simple Authentication: Use just a session ID or cookies - no complex multi-account logic
• ✅ Message Randomization: Use {option1|option2} syntax for variations
• ✅ Smart Delays: Random delays between messages to avoid rate limits
• ✅ Session Saving: Automatically save your session for future use
• ✅ Clean Error Handling: Clear error messages with troubleshooting tips

🚀 Quick Start

Option 1: Using Session ID (Easiest)

1. Get your Session ID:

   • Open Instagram in your browser
   • Press F12 to open Developer Tools
   • Go to Application tab → Cookies → https://www.instagram.com
   • Find sessionid and copy its full value

2. Use it in your input:

{
  "sessionId": "4226293692%3AIwN466asfWq4tt%3A12%3AAYg4rG...",
  "usernames": ["user1", "user2", "user3"],
  "message": "Hey {there|hi}! How are you?",
  "min_delay": 90,
  "max_delay": 180,
  "save_session": true
}

Option 2: Using Cookies (Advanced)

Export your Instagram cookies using a browser extension like EditThisCookie or Cookie-Editor.

{
  "cookies": "[{\"name\":\"sessionid\",\"value\":\"...\"}]",
  "usernames": ["user1", "user2"],
  "message": "Hello!"
}

📝 Input Parameters

Parameter	Type	Required	Description
sessionId	string	Yes*	Instagram session ID (easier option)
cookies	string	Yes*	Instagram cookies in JSON format (advanced)
usernames	array	Yes	List of Instagram usernames to message
message	string	Yes	Message template (supports {opt1|opt2} randomization)
min_delay	integer	No	Min delay between messages in seconds (default: 90)
max_delay	integer	No	Max delay between messages in seconds (default: 180)
save_session	boolean	No	Save session for future use (default: true)
proxy	string	No	Residential proxy URL (format: http://user:pass@host:port)

*Either sessionId OR cookies is required, not both.

🌐 Using Residential Proxies (Recommended)

Residential proxies help avoid IP-based rate limiting and detection. Highly recommended for bulk operations.

Supported formats:

• HTTP: http://username:password@proxy.example.com:8080
• HTTPS: https://username:password@proxy.example.com:8080
• SOCKS5: socks5://username:password@proxy.example.com:1080

Example with proxy:

{
  "sessionId": "your_session_id",
  "proxy": "http://user:pass@residential-proxy.com:8080",
  "usernames": ["user1", "user2"],
  "message": "Hey!"
}

Benefits of using proxies:

• ✅ Avoid IP-based rate limits
• ✅ Reduce chance of account blocks
• ✅ Better for bulk operations
• ✅ Rotate IPs automatically (with rotating proxies)

🎨 Message Randomization

Use curly braces with pipe separators to create message variations:

{
  "message": "Hey {there|hi|hello}, how are you {doing|feeling} today?"
}

Each message will randomly select one option:

• "Hey there, how are you doing today?"
• "Hey hi, how are you feeling today?"
• "Hey hello, how are you doing today?"
• etc.

⚙️ How It Works

1. Authentication: Logs in using your session ID or cookies
2. Message Generation: Creates randomized messages for each recipient
3. Smart Sending: Sends messages with random delays to avoid detection
4. Result Tracking: Tracks successful and failed deliveries
5. Session Saving: Optionally saves your session for reuse

🔒 Rate Limits & Best Practices

• Recommended Delays: 90-180 seconds between messages
• Daily Limits: Instagram may limit you to ~50-100 messages per day
• Account Safety: Use delays of 2-5 minutes for maximum safety
• Fresh Sessions: Get a new session ID if you see authentication errors
• One Account: This simplified version uses ONE account at a time

📊 Output Format

{
  "success": true,
  "total_sent": 10,
  "total_failed": 2,
  "sent": [
    {
      "username": "user1",
      "user_id": "123456789",
      "message": "Hey there, how are you?",
      "timestamp": "2026-02-11T20:30:00Z"
    }
  ],
  "failed": [
    {
      "username": "user2",
      "error": "User not found",
      "timestamp": "2026-02-11T20:35:00Z"
    }
  ]
}

🛠️ Troubleshooting

"Login failed: expired session"

• Your session ID has expired
• Get a fresh session ID from your browser
• Make sure you're logged into Instagram when copying it

"Account blocked or rate-limited"

• You've sent too many messages
• Wait 24-48 hours before trying again
• Use longer delays (3-5 minutes) next time

"User not found"

• The username doesn't exist
• Check for typos in the username
• Make sure you're not including the @ symbol (it's removed automatically)

🔄 Changes from Previous Version

This simplified version removes:

• ❌ Multiple account support
• ❌ Account rotation strategies
• ❌ Retry with different accounts
• ❌ Message per account limits
• ❌ Bulk sessions array

Benefits:

• ✅ Simpler configuration
• ✅ Easier to understand
• ✅ Less prone to errors
• ✅ Focused on single-account reliability

📄 License

MIT License - See LICENSE file for details

⚠️ Disclaimer

This tool is for educational purposes. Use responsibly and in accordance with Instagram's Terms of Service. Sending unsolicited messages may result in your account being restricted or banned.

---

Need the old multi-account version? Contact the developer or check previous commits.