Check if phone numbers are connected to Telegram accounts.
Project description
telegram-phone-number-checker
Python tool/script toc heck if phone numbers are connected to Telegram accounts.
Installation
You can install this tool directly from the official pypi release.
pip install telegram-phone-number-checker
You can also install it and run it directly from github as a script.
git clone https://github.com/bellingcat/telegram-phone-number-checker
cd telegram-phone-number-checker
pip install -r requirements.txt
python telegram-phone-number-checker/main.py
Requirements
To run it, you need:
- A Telegram account with an active phone number;
- Telegram
API_ID
andAPI_HASH
, 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:
API_ID=
API_HASH=
PHONE_NUMBER=
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
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:
# single phone number
telegram-phone-number-checker --phone-numbers +1234567890
# multiple phone numbers
telegram-phone-number-checker --phone-numbers +1234567890,+9876543210,+111111111
# interactive version, you will be prompted for the phone-numbers
telegram-phone-number-checker
# overwrite the telegram API keys in .env (or if no .env is found)
telegram-phone-number-checker --api-id YOUR_API_KEY --api-hash YOUR_API_HASH --api-phone-number YOUR_PHONE_NUMBER --phone-numbers +1234567890
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 your_filename.json
to the command.
For each phone number, you can expect the following possible responses:
- If available, you will receive the Telegram Username,Name, and ID that are connected with this number.
- 'no username detected'. This means that it looks like the number was used to create a Telegram account but the user did not choose a Telegram Username. It is optional to create a Username on Telegram.
- 'ERROR: no response, the user does not exist or has blocked contact adding.': There can be several reasons for this response. Either the phone number has not been used to create a Telegram account. Or: The phone number is connected to a Telegram account but the user has restricted the option to find him/her via the phone number.
- Or: another error occurred.
Development
This section describes how to install the project in order to run it locally, for example if you want to build new features.
# clone the code
git clone https://github.com/bellingcat/telegram-phone-number-checker
# move into the project's folder
cd telegram-phone-number-checker
This project uses poetry to manage dependencies. You can install dependencies via poetry, or use the up-to-date requirements.txt file.
# with poetry
poetry install
# with pip
pip install -r requirements.txt
You can then run it with any of these:
# with poetry
poetry run python3 telegram_phone_number_checker/main.py
# with pip installation
python3 telegram_phone_number_checker/main.py
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for telegram_phone_number_checker-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | cfafa36c7c9215e80b2382ea1f6ef119a96e83803a059a0b867264527a386259 |
|
MD5 | 11e9c399d5a57851f0472130ce5e15d6 |
|
BLAKE2b-256 | 8125d7d99d397f75fc7db66fa18b19b506f93bb615e908f2f7a3228b7fdcbcb5 |
Hashes for telegram_phone_number_checker-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d3639fd5d060a78e330c6516a90a66db30f4d9b1b4944459e510da22f3454981 |
|
MD5 | 5eb385d3db426c62cb11930ac987fce4 |
|
BLAKE2b-256 | f2f72b809aa4febad7295f90780df86f46351c767008e6ee8168810fbcaf5e29 |