🔍 Email Intelligence Telegram Bot A powerful Telegram bot for comprehensive email lookup and intelligence gathering. Get detailed information about any email address including breach history, Google account data, service registrations, and more - all with beautiful formatting and strong privacy features.
✨ Features 🔍 Email Intelligence Complete email lookup with real API integration
Data breach detection with source details
Google account information (ID, profile, apps, stats)
Service registration status (registered/unregistered)
Email provider and domain validation
First seen / last seen timestamps
👑 Admin Controls Full admin panel with interactive buttons
Excel export of all user data and searches
Bulk email checking (one message per email)
File upload support for bulk processing (.txt)
User management (view, approve, reject)
Daily limit reset for all users
No auto-delete for admin messages
🔒 Privacy & Security Auto-delete user messages instantly after sending
Auto-delete results after 10 minutes (users only)
Admin-only commands strictly enforced
Verification system with admin approval
Terms acceptance required before use
Rate limiting to prevent abuse
Database tracking of all activity
🎉 User Experience Beautiful formatted responses (no JSON files)
Emoji rain celebration when approved by admin
Quick loading messages with auto-delete
Contact admin button for support
Personal statistics dashboard
Daily usage tracking
📋 Table of Contents Installation
Configuration
Running the Bot
Commands
Admin Features
User Features
Privacy Features
Database Schema
API Integration
Troubleshooting
Deployment
🚀 Installation Prerequisites Python 3.8 or higher
Telegram Bot Token (from @BotFather)
API Key (from service provider)
Telegram User ID (get from @userinfobot)
Step 1: Clone the Repository bash git clone https://github.com/Devil-bgmi/GMAIL-OSINT.git cd email-intelligence-bot Step 2: Install Dependencies bash pip install -r requirements.txt Step 3: Create Configuration File Create a .env file in the root directory:
env
BOT_TOKEN=your_bot_token_here
API_KEY_1=your_primary_api_key API_KEY_2=your_secondary_api_key_optional
ADMIN_ID=123456789
DATABASE_URL=sqlite:///users.db Step 4: Create Directories The bot will automatically create these folders:
uploads/ - For admin file uploads
api_debug/ - For API debug logs
exports/ - For Excel exports
⚙️ Configuration .env Configuration Variable Description Required BOT_TOKEN Your Telegram bot token ✅ API_KEY_1 Primary API key ✅ API_KEY_2 Secondary API key (for bulk) ❌ ADMIN_ID Your Telegram user ID ✅ DATABASE_URL Database connection string ❌ Database Configuration Default: SQLite (sqlite:///users.db)
For production, you can use PostgreSQL:
env DATABASE_URL=postgresql://user:password@localhost/emailbot 🏃 Running the Bot Local Development bash
python bot_main.py
Testing API Connection The bot automatically tests the API on startup:
bash 🔍 Testing API connection... ✅ Connected! 📧 Email: test@gmail.com 📅 First seen: 2026-02-10T05:03:10Z 📱 Commands User Commands Command Description /start Start bot and accept terms /help Show help message /verify Check verification status /contact Contact admin directly /stats View your statistics Admin Commands Command Description /admin Open admin control panel /export Export all data to Excel /bulk Bulk email checking /bulk email1@gmail.com email2@gmail.com Bulk check specific emails 👑 Admin Features Admin Panel (/admin) text 🔧 Admin Panel 👑 Admin ID: 123456789 Select an option: [📊 View Statistics] [👥 Pending Verifications] [📋 All Users] [📥 Export All Data] [📧 Bulk Email Check] [🔄 Reset Daily Limits] Export Data (/export) Generates Excel file with:
All Searches sheet: Complete lookup history
All Users sheet: User information and stats
Summary sheet: Overall statistics
Bulk Checking (/bulk) Process multiple emails with one message per email:
text 📧 Processing 3 emails in bulk... [Message 1] Full results for email1@gmail.com [Message 2] Full results for email2@gmail.com [Message 3] Full results for email3@gmail.com 📊 Bulk Processing Complete ✅ Successful: 3 ❌ Failed: 0 File Upload Upload .txt files with one email per line for bulk processing.
👤 User Features Terms Acceptance On /start, users see:
text 🔍 Email Intelligence Bot
📋 Features: ✅ Complete email lookup ✅ Data breach detection ✅ Google account information
📜 Terms & Conditions:
- Legitimate use only
- Only check emails you own
- No illegal activities
[✅ I Accept] [❌ I Decline] Approval Celebration When admin approves a user:
text 🎉 WELCOME TO THE BOT! ✨ Your account has been approved! ✨
🎊 You can now use all features: • Email lookup with full details • Data breach detection • Google account information
🎉 🎊 ✨ 🥳 🎈 👏 🔥 💫 Email Lookup Results text 🔍 Email Intelligence Results
📧 Email: example@gmail.com 📅 First Seen: Feb 10, 2026 📅 Last Seen: Feb 10, 2026
🛡️ DATA BREACHES ✅ No data breaches found (Safe)
📧 EMAIL ACCOUNT • Domain: gmail.com • Provider: Gmail • Can receive email: ✅ Yes
🔵 GOOGLE ACCOUNT FOUND • Last Active: Feb 10, 2026 (05:03 AM UTC) • Google Apps: Photos, Kaboo, Maps, Meet • Google Chat Type: PERSON • Enterprise User: ❌ No
✅ REGISTERED ACCOUNTS (3 services)
- Spotify
- Domain
⛔ NOT REGISTERED (22 services) • Adobe, Bitmoji, Chess.com, Dropbox, Duolingo...
🔐 SECURITY SUMMARY • Data breaches: ✅ Safe • Google account: ✅ Found • Services checked: 25
──────────────────────────────────────── 🔍 Powered by Email Intelligence API 🛡️ Data privacy protected ⏰ Note: This message auto-deletes in 10 minutes Google Profile Image If available, the bot also sends the Google profile image as a photo.
🔒 Privacy Features Auto-Delete System Message Type User Admin User's email message Deletes instantly Permanent Loading message Deletes after results Permanent Results message Deletes after 10 min Permanent Google profile photo Deletes after 10 min Permanent How Auto-Delete Works python
USER: "test@gmail.com" ⚡ Deletes instantly
BOT: "🔍 Loading..." ⚡ Deletes after results
BOT: [Formatted results] ⏰ Deletes after 10 minutes Security Features ✅ Admin-only commands strictly enforced
✅ Rate limiting (20 emails/day per user)
✅ Terms acceptance required
✅ Admin approval required
✅ Database tracking of all activity
✅ No sensitive data in logs
📊 Database Schema Users Table Column Type Description user_id Integer Telegram user ID (unique) username String Telegram username first_name String User's first name last_name String User's last name is_verified Boolean Admin verification status terms_accepted Boolean Terms acceptance status daily_limit Integer Daily email limit emails_checked_today Integer Today's usage count total_checks Integer Lifetime total checks created_at DateTime Account creation date Search History Table Column Type Description user_id Integer Who performed the search email String Email that was looked up result Text JSON result data timestamp DateTime When lookup occurred source String 'user' or 'admin' or 'bulk' Verification Requests Table Column Type Description user_id Integer User requesting verification status String pending/approved/rejected created_at DateTime Request timestamp processed_by Integer Admin who processed 🔌 API Integration API Response Structure The bot handles this exact structure:
json { "data_breaches": { "amount": 0, "results": [], "sources": 0 }, "identifier": { "accounts": [ { "module": {"name": "domain"}, "data": { "can_receive_email": true, "email_provider": "gmail" } }, { "module": {"name": "google"}, "data": { "last_seen_date": "2026-02-10T05:03:10Z", "active_google_apps": ["Photos", "Maps", "Meet"], "enterprise_user": false, "google_chat_extended_data": { "entity_type": "PERSON" } } } ] }, "meta": { "first_seen": "2026-02-10T05:03:10Z", "last_seen": "2026-02-10T05:03:10Z", "email": "example@gmail.com" }, "validator": { "registered": [...], "unregistered": [...] } } API Error Handling 403: Access denied - check IP whitelisting
429: Rate limited - slow down requests
500: Server error - try again later
Timeout: Connection issues - check network
🐛 Troubleshooting Common Issues
- "API Access Denied (403)" Solution: Whitelist your server IP on API provider dashboard
python
import requests print(requests.get('https://api.ipify.org').text) 2. "Bot not responding" Solution: Check bot token and start bot with /start
-
"Database errors" Solution: Check database permissions and file paths
-
"Admin commands not working" Solution: Verify ADMIN_ID in .env matches your Telegram ID
-
"Auto-delete not working" Solution: Bot needs delete message permission in groups
Logs Check bot.log for detailed error information:
bash tail -f bot.log 🚢 Deployment Deploy on Pella Bot Hosting Prepare files:
bash zip -r email-bot.zip * -x ".git" ".env" "pycache/*" Upload to Pella:
Go to Pella Bot dashboard
Upload the zip file
Set main file as bot_main.py
Add environment variables in Pella panel
Environment Variables on Pella:
text BOT_TOKEN=your_bot_token API_KEY_1=your_api_key API_KEY_2=your_second_key ADMIN_ID=123456789 Start the bot:
Pella will automatically run pip install -r requirements.txt
Then execute python bot_main.py
Deploy on VPS bash
pip install -r requirements.txt
npm install -g pm2 pm2 start bot_main.py --interpreter python3 --name email-bot pm2 save pm2 startup
IP Whitelisting (If Required) If API provider requires IP whitelisting:
Get your server IP: curl ifconfig.me
Add to API provider dashboard
Test connection
📝 License This project is licensed under the MIT License - see the LICENSE file for details.
🤝 Contributing Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request
📞 Support Telegram: @the_BR_king
Issues: GitHub Issues
Documentation: Wiki
🙏 Acknowledgements Thanks to all contributors and users
Built with Python and Telegram Bot API
⭐ Show Your Support Give a ⭐️ if this project helped you!
Made with ❤️ for the Telegram community