INSTALLATION:
git clone https://github.com/Nkipohcs/leak_checker.git
cd leak_checker
pip install -r requirements.txtUSAGE:
python3 leaklookup.py [OPTIONS] COMMAND [ARGS]...DESCRIPTION:
This script allows you to search for information in the Leak Lookup database via their API.
COMMANDS:
search: Perform a search in the Leak Lookup database.stats: Get usage statistics for the current API key.
GLOBAL OPTIONS:
-h,--help: Show this help message and exit.
API KEY SETUP:
To use this tool, you need one or more Leak Lookup API keys. You can obtain them from: https://leak-lookup.com/api
API keys are managed via a .env file in the root directory of the project. Create a file named .env and add your API keys in the following format:
LEAKLOOKUP_API_KEYS="YOUR_API_KEY_1,YOUR_API_KEY_2,YOUR_API_KEY_3"
Replace YOUR_API_KEY_1, YOUR_API_KEY_2, etc., with your actual API keys, separated by commas. The script will automatically cycle through these keys if one hits its request limit.
An example .env.example file is provided for reference.
HOW TO PERFORM A SEARCH (using search subcommand):
To perform a search, use the search command:
python3 leaklookup.py searchThe script will then prompt you to enter your desired search query.
To specify a search type, use the -t or --type option with the search command:
python3 leaklookup.py search -t phoneOr provide the query directly:
python3 leaklookup.py search -q "[email protected]" -t email_addressSEARCH WITH:
You can search using various data types, including:
- Email addresses
- Phone numbers
- Passwords
- Usernames
- Geographical data (state, city, zipcode)
- IP addresses
- User IDs (userid, fbid)