Telegram Account Checker: A Python script to check Telegram accounts using phone numbers or usernames

GitHub: https://github.com/unnohwn/telegram-checker

Enhanced version of bellingcat's Telegram Phone Checker!

A Python script to check Telegram accounts using phone numbers or usernames, now with more detailed user information and enhanced status display.

✨ Features

🔍 Check single or multiple phone numbers and usernames.
📁 Import numbers and usernames from text files.
📸 Auto-download all profile pictures for a user.
💾 Save results as detailed JSON files.
🔐 Secure credential storage (API ID, hash, and phone number in config.pkl).
📊 Detailed user information, including:
- Basic info: ID, username, first/last name, phone.
- Account status: Premium, Verified, Bot, Fake.
- Enhanced last seen status: Online, Offline (with exact timestamp), Recently, Last Week, Last Month, or Unavailable, nothing if privacy is restricted.
- Profile details: Bio, common chats count.
- Interaction status: Blocked by user.
📝 Logging of operations to telegram_checker.log.
🎨 Rich console output for better readability and interaction.
💨 Option to clear saved credentials and session.

🚀 Installation

Clone the repository:

git clone https://github.com/unnohwn/telegram-checker.git
cd telegram-checker

Install required packages:

pip install -r requirements.txt

📦 Requirements

Contents of requirements.txt:

telethon
rich
click
python-dotenv

Or install packages individually:

pip install telethon rich click python-dotenv

⚙️ Configuration

First time running the script, you'll need:

Telegram API credentials (get from https://my.telegram.org/apps)
Your Telegram phone number including countrycode +
Verification code (sent to your Telegram)

💻 Usage

Run the script:

python telegram_checker.py

Choose from options:

Check phone numbers from input
Check phone numbers from file
Check usernames from input
Check usernames from file
Clear saved credentials
Exit

📂 Output

Results are saved in:

results/ - JSON files with detailed information
profile_photos/ - Downloaded profile pictures

📊 Result EXAMPLE

The script provides both a summary in the console and detailed JSON output.

Enhanced Results Summary (Console Output Example):

Enhanced Results Summary:
✓ +12345678900: John Doe (@johndoe_example)
  📅 Exact time: 2025-05-25 10:30:45 UTC
  📝 Bio: Just an example bio here. Living the example life! Follow for more examples...
  ⭐ Telegram Premium user
  ✅ Verified account
  👥 Common chats: 2
  📸 Profile photos downloaded: 2

✓ example_user: Jane Smith (@example_user)
  📅 Status: Last seen recently (1 second - 3 days ago) [yellow](Privacy restricted - exact time hidden)[/yellow]
  📝 Bio: Exploring the digital world.
  🚫 User has blocked you
  📸 Profile photos downloaded: 1

❌ +98765432100: No Telegram account found

Detailed Results (JSON Output Example - content of results/results_YYYYMMDD_HHMMSS.json):

{
"+12345678900": {
"id": 123456789,
"username": "johndoe_example",
"first_name": "John",
"last_name": "Doe",
"phone": "+12345678900",
"premium": true,
"verified": true,
"fake": false,
"bot": false,
"last_seen": "Last seen: 2025-05-25 10:30:45 UTC",
"last_seen_exact": "2025-05-25 10:30:45 UTC",
"status_type": "offline",
"bio": "Just an example bio here. Living the example life! Follow for more examples...",
"common_chats_count": 2,
"blocked": false,
"profile_photos": [
"profile_photos/123456789_+12345678900_photo_0.jpg",
"profile_photos/123456789_+12345678900_photo_1.jpg"
],
"privacy_restricted": false
},
"example_user": {
"id": 987654321,
"username": "example_user",
"first_name": "Jane",
"last_name": "Smith",
"phone": "",
"premium": false,
"verified": false,
"fake": false,
"bot": false,
"last_seen": "Last seen recently (1 second - 3 days ago)",
"last_seen_exact": null,
"status_type": "recently",
"bio": "Exploring the digital world.",
"common_chats_count": 0,
"blocked": true,
"profile_photos": [
"profile_photos/987654321_example_user_photo_0.jpg"
],
"privacy_restricted": true
},
"+98765432100": {
"error": "No Telegram account found"
}
}