Holehe: Efficiently Finding Registered Accounts from Emails

Holehe: Efficiently Finding Registered Accounts from Emails

Holehe is a Python project that allows users to check if an email is attached to an account on various sites such as Twitter, Instagram, Imgur, and more than 120 others. It offers a convenient way to validate email addresses and retrieve valuable information from sites that have a forgotten password function. The project's versatility makes it a valuable tool for a wide range of users.

Installation

There are two ways to install Holehe:

• With PyPI: Run the command pip3 install holehe in your command line interface.
• With GitHub: Clone the project repository using the command git clone https://github.com/megadose/holehe.git. Then navigate to the cloned directory using cd holehe/ and install the project by running python3 setup.py install.

Quick Start

Holehe is designed to be user-friendly and can be run from the command line interface or easily integrated into existing Python applications. Below are two examples of how to use Holehe:

CLI Example

Open your terminal and run the following command:

      $ holehe -e test@gmail.com
    

This command will check if the email "test@gmail.com" is registered on various sites and display the results.

Python Example

If you prefer to use Holehe within your Python code, you can use the following example:

      
import trio
import httpx
from holehe.modules.social_media.snapchat import snapchat
async def main():
    email = "test@gmail.com"
    out = []
    client = httpx.AsyncClient()
    await snapchat(email, client, out)
    print(out)
    await client.aclose()
trio.run(main)
    

This code snippet demonstrates how to check if the email "test@gmail.com" is registered on Snapchat using the Holehe module for Snapchat. The result will be printed in the console.

Module Output

Each Holehe module returns data in a standard dictionary format, providing valuable information about the registered account:

      
{
  "name": "example",
  "rateLimit": false,
  "exists": true,
  "emailrecovery": "ex****e@gmail.com",
  "phoneNumber": "0*******78",
  "others": null
}
    

The dictionary includes:

• name: The name of the module.
• rateLimit: Indicates whether you've been rate-limited by the service.
• exists: A boolean value indicating if an account exists for the provided email.
• emailrecovery: Sometimes partially obfuscated recovery emails are returned.
• phoneNumber: Sometimes partially obfuscated recovery phone numbers are returned.
• others: Any extra information available.

If you encounter rate-limiting issues, it is recommended to change your IP address to avoid restrictions. Holehe also offers a Maltego Transform that provides even more functionality for data analysis and visualization.

Examples of Built-in Modules

Holehe comes with an extensive list of built-in modules to check account registration for various sites. Here are a few examples:

• Amazon: Allows you to verify if an email is associated with an Amazon account.
• Instagram: Checks if the email is registered on Instagram.
• Spotify: Verifies the existence of a Spotify account with the provided email.
• Twitter: Checks if the email is associated with a Twitter account.
• Yahoo: Verifies if the email is registered on Yahoo.

These are just a few of the many modules available with Holehe. The extensive module library provides users with the flexibility to explore various platforms and verify account existence.

License

Holehe is released under the GNU General Public License v3.0 and is built for educational purposes only. Make sure to comply with the license terms when using the project.

Explore the Full List of Modules

If you're interested in exploring the full list of modules available with Holehe, you can visit the project's GitHub repository:

Holehe GitHub Repository