> ## Content Index
> Fetch the complete content index at: https://darkwebinformer.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Telegram Account Checker
- URL: https://darkwebinformer.com/telegram-account-checker/
- Published: 2025-06-13T17:04:37.000Z
- Updated: 2025-09-04T22:21:45.000Z
- Author: Dark Web Informer
- Tags: Tools, OSINT

---

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

[](https://github.com/unnohwn/telegram-checker#-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

[](https://github.com/unnohwn/telegram-checker#-installation)

1. Clone the repository:

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

1. Install required packages:

pip install -r requirements.txt

## 📦 Requirements

[](https://github.com/unnohwn/telegram-checker#-requirements)

Contents of `requirements.txt`:

```
telethon
rich
click
python-dotenv

```

Or install packages individually:

pip install telethon rich click python-dotenv

## ⚙️ Configuration

[](https://github.com/unnohwn/telegram-checker#%EF%B8%8F-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

[](https://github.com/unnohwn/telegram-checker#-usage)

Run the script:

python telegram\_checker.py

Choose from options:

1. Check phone numbers from input
2. Check phone numbers from file
3. Check usernames from input
4. Check usernames from file
5. Clear saved credentials
6. Exit

## 📂 Output

[](https://github.com/unnohwn/telegram-checker#-output)

Results are saved in:

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

## 📊 Result EXAMPLE

[](https://github.com/unnohwn/telegram-checker#-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"  
 }  
}

## ⚠️ Note

[](https://github.com/unnohwn/telegram-checker#%EF%B8%8F-note)

This tool is for educational purposes only. Please respect Telegram's terms of service and user privacy.

## 📄 License

[](https://github.com/unnohwn/telegram-checker#-license)

MIT License