Telegram Phone Number Checker

Command line tool for checking if phone numbers are connected to Telegram accounts and retrieving related information where available.

URL

Try it on Google Colab

Get the code from GitHub

Description

The Telegram Phone Number Checker is a Python-based command line tool that takes phone numbers and uses the Telegram API to find information about the number. It does this by trying to add the number as a contact on your Telegram account.

When investigating a phone number of interest, this tool may help a user find more information about the owner of the phone number. If adding the contact is successful, the tool extracts public information that could include the account username, first name, last name, profile photo, and when they were last online.

View the full list of data fields the tool attempts to collect.

id, username, usernames, first_name, last_name, fake, verified, premium, mutual_contact, bot, bot_chat_history, restricted, restriction_reason, user_was_online, phone

The profile_photo can be optionally requested

If adding the contact fails, it could be that the person is not on Telegram or has disabled contact adding in their Telegram privacy settings.

Cost

• Free

• Partially Free

• Paid

Level of difficulty

Requirements

A Telegram developer account and API key.

Basic to intermediate experience with the Python programming language.

Limitations

The tool can lead to your Telegram account being blocked, which seems more likely if you use the tool for large numbers of phone numbers or if you use a VPN (that could be associated with spam activity).

To mitigate this risk, it is recommended to avoid using your personal account with this tool.

Ethical Considerations

It is possible to gain access to people's names and images using this tool, and should be used as part of tightly scoped investigations. Users should be cautious not to disclose personal information about individuals they are investigating when sharing their findings.

Guides and articles

YouTube Tutorial

Bellingcat article: "How Code Notebooks Enable Open Source Research", Miguel Ramalho

Tool provider

Bellingcat, Netherlands

Advertising Trackers

• This tool has not been checked for advertising trackers yet.

• This tool uses tracking cookies. Use with caution.

• This tool does not appear to use tracking cookies.

Page maintainer
Galen Reich
Afton