SearchPhone 🕵🏽‍♂️

Is a comprehensive OSINT tool for looking up linked phone number information, using multiple APIs to gather information from various sources. Developed for use with Python from the terminal. 👁

✨ Features

• 📱 Phone Number Validation - Validates and formats phone numbers using phonenumbers library
• 🔍 Multiple Search Engines - Searches Google (via SerpAPI), DuckDuckGo, and Bing
• 💻 Code Repository Search - Finds phone numbers in GitHub code
• 📝 Social Media Search - Searches Reddit for mentions
• 📊 Carrier Information - Gets operator and location data via Numverify API
• 📄 Automatic Reports - Generates JSON and PDF reports automatically
• 🚀 Parallel Processing - Searches multiple sources simultaneously for speed
• 🎨 Colorful Output - Easy to read terminal output with colors

🔑 API Keys Required

Get your API keys from the following services:

Service	Purpose	Link	Plan	Key
Numverify	Phone number validation & carrier info	numverify.com	Free (100 requests/month)	🔑 (Necessary)
SerpAPI	Google Search results	serpapi.com	Free (250 searches/month)	🔑 (Necessary)
GitHub Token	GitHub code search	GitHub Settings	Free (5000 requests/hour)	🔑 (Necessary)

Configure your API keys:

The project includes an example.env file with the required variables. Follow these steps:

Step 1: Copy the example file

cp example.env .env

Step 2: Edit the .env file

nano .env

or

vim .env

or

code .env

Step 3: Add your API keys

Replace the placeholder values with your actual API keys:

# Required APIs
NUMVERIFY_KEY=your_numverify_api_key_here
SERPAPI_KEY=your_serpapi_key_here
GITHUB_TOKEN=your_github_token_here

Example

The project is open to partners.

SUPPORTED DISTRIBUTIONS

Distribution	Verified version	Supported	Status
Kali Linux	2026.2	✅	Working
Parrot Security OS	6.3	✅	Working
Windows	11	✅	Working
BackBox	9	✅	Working
Arch Linux	2024.12.01	✅	Working

USAGE

git clone https://github.com/HackUnderway/SearchPhone.git

cd SearchPhone

python3 search_phone.py

REQUIREMENTS

pip install -r requirements.txt

SUPPORT

Questions, bugs or suggestions to : info@hackunderway.com

LICENSE

• SearchPhone is licensed.
• See LICENSE for more information.

👨‍💻 Author

• Victor Bancayan - (CEO at Hack Underway)

🔗 Links

☕️ Support the project

If you like this tool, consider buying me a coffee:

🌞 Subscriptions

Subscribe to: Jey Zeta

from made in with by: Victor Bancayan

© 2026