telegram-phone-number-checker
Python tool/script to check if phone numbers are connected to Telegram accounts. Retrieving username, name, and IDs where available.
⚠️ NB: We advise you not to use your personal account for automations as telegram may block it. A fresh account works best from residential IPs rather than known VPN IPs.
Installation
You can install this tool directly from the official pypi release.
You can also install it and run it directly from GitHub as a script.
Requirements
To run it, you need:
1. A Telegram account with an active phone number;
2. Telegram APIID and APIHASH, which you can get by creating a developers account at https://my.telegram.org/. Place these values in a .env file, along with the phone number of your Telegram account:
If you don't create this file, you can also provide these 3 values when calling the tool, or even be prompted for them interactively.
Usage
Search by phone number
The tool accepts a comma-separated list of phone numbers to check, you can pass this when you call the tool, or interactively.
See the examples below:
Search by Username
You can also search by Telegram username(s):
The result will be written to the console but also written as JSON to a results.json file, you can write it to another file by adding --output yourfilename.json to the command.
Connecting through a proxy
If you need to connect through a SOCKS5/SOCKS4/HTTP proxy (for example, to avoid
using a known VPN/datacenter IP - see the warning above), install the optional
proxy extra and pass --proxy:
The proxy can also be set via the PROXY environment variable or in your .env file.
For each phone number or username, you can expect the following possible responses:
1. If available, you will receive the Telegram Username, Name, and ID that are connected with this number.
[truncated]
Python tool/script to check if phone numbers are connected to Telegram accounts. Retrieving username, name, and IDs where available.
⚠️ NB: We advise you not to use your personal account for automations as telegram may block it. A fresh account works best from residential IPs rather than known VPN IPs.
Installation
You can install this tool directly from the official pypi release.
You can also install it and run it directly from GitHub as a script.
Requirements
To run it, you need:
1. A Telegram account with an active phone number;
2. Telegram APIID and APIHASH, which you can get by creating a developers account at https://my.telegram.org/. Place these values in a .env file, along with the phone number of your Telegram account:
If you don't create this file, you can also provide these 3 values when calling the tool, or even be prompted for them interactively.
Usage
Search by phone number
The tool accepts a comma-separated list of phone numbers to check, you can pass this when you call the tool, or interactively.
See the examples below:
Search by Username
You can also search by Telegram username(s):
The result will be written to the console but also written as JSON to a results.json file, you can write it to another file by adding --output yourfilename.json to the command.
Connecting through a proxy
If you need to connect through a SOCKS5/SOCKS4/HTTP proxy (for example, to avoid
using a known VPN/datacenter IP - see the warning above), install the optional
proxy extra and pass --proxy:
The proxy can also be set via the PROXY environment variable or in your .env file.
For each phone number or username, you can expect the following possible responses:
1. If available, you will receive the Telegram Username, Name, and ID that are connected with this number.
[truncated]