One-Click Telegram Username Checker for Bulk Availability and Monitoring

Intro: Security researchers use Telegram for OSINT and brand monitoring; manual username checks are inefficient. DarkWebInformer released an open‑source Telethon‑based command‑line tool that supports batch queries, watch mode, and alternative name suggestions.

Tool Overview

Telegram Channel & Username Availability Checker interacts with the Telegram API via Telethon to determine whether a username is available, taken, or malformed.

GitHub repository: https://github.com/DarkWebInformer/telegram-checker

Core Features

Availability Status Detection

The tool classifies each query into four categories:

AVAILABLE (🟢): username not registered and can be claimed.

TAKEN (🔴): username already taken; returns title, member count, description, and other metadata.

INVALID (⚪): username does not meet Telegram format rules.

UNKNOWN (🟡): temporary errors such as network glitches or FloodWait limits.

Batch Processing

Input methods:

Direct arguments: python telegram_checker.py name1 name2 name3 CSV/TXT files: automatically detects the username column.

Piped input:

cat names.txt | python telegram_checker.py

Watch Mode

Using the --watch flag the tool periodically re‑checks a list and reports only state changes.

python telegram_channel_checker.py -i watchlist.txt --watch 60

Alternative Name Suggestion

The --suggest option generates and tests similar variants when a target name is taken.

python telegram_channel_checker.py mybrand --suggest

Rich Metadata for Taken Names

Channel title and type (channel, supergroup, gigagroup, etc.)

Member count and last active time

Verification, scam, fake, or restriction flags

Security Design

Malicious Data Handling

Channel titles and descriptions may contain formula injection or terminal escape characters. The tool sanitises CSV output and strips control characters before displaying them.

Credential Protection

Users obtain api_id and api_hash from https://my.telegram.org and provide them via environment variables or a .env file. A .gitignore entry prevents accidental commit of sensitive files. The generated .session file contains login credentials and must be stored securely.

Installation & Usage

Dependencies

Python 3.10+

Telethon

tqdm (optional, for progress bars)

pip install telethon
pip install tqdm

Basic Commands

# Single check
python telegram_channel_checker.py durov

# Batch file check
python telegram_channel_checker.py -i names.csv -o results.csv

# Show only available usernames
python telegram_channel_checker.py -i names.csv --available-only

# Resume large file processing
python telegram_channel_checker.py -i big_list.csv -o results.csv --resume

Output Formats

The tool can emit colored terminal cards, CSV, or JSON. CSV fields include username, status, channel type, member count, verification flag, and last active time. Results are written in real time; interrupting with Ctrl+C does not lose completed entries, and the --resume flag allows continuation.

Typical Use Cases

Brand Protection : monitor whether a brand name is being squatted.

OSINT Intelligence Gathering : bulk collection of Telegram community information.

Squat Monitoring : watch for release of desired usernames.

Asset Management : detect phishing channels impersonating a company.