HackUnderway/SearchPhone

Phone number OSINT toolkit with multi-API search (Google, GitHub, Numverify, Reddit, DuckDuckGo), Hudson Rock infostealer intelligence, and automatic report generation.

Python

2,037

13 commits

updated Aug 24, 2026

See the code

README

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. 👁

SearchPhone

Python version License

✨ Features

  • 📱 Phone Number Validation - Validates and formats phone numbers using phonenumbers library
  • 🔍 Multiple Search Engines - Searches Google (via SerpAPI) and DuckDuckGo
  • 💻 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
  • 🛡️ Infostealer Intelligence - Checks if a phone number has been compromised by info-stealer malware via Hudson Rock Cavalier API (free, no API key required)
  • 📄 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:

ServicePurposeLinkPlanKey
NumverifyPhone number validation & carrier infonumverify.comFree (100 requests/month)🔑 (Necessary)
SerpAPIGoogle Search resultsserpapi.comFree (250 searches/month)🔑 (Necessary)
GitHub TokenGitHub code searchGitHub SettingsFree (5000 requests/hour)🔑 (Necessary)
Hudson RockInfostealer intelligencecavalier.hudsonrock.comFree (No API key required)❌ No key needed

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

SearchPhone

SearchPhone

The project is open to partners.

SUPPORTED DISTRIBUTIONS

DistributionVerified versionSupportedStatus
Kali Linux2026.2✅Working
Parrot Security OS6.3✅Working
Windows11✅Working
BackBox9✅Working
Arch Linux2024.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 : [email protected]

LICENSE

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

👨‍💻 Author


🕵️‍♂️ OSINT Platform

OSINT Platform

Automate OSINT processes
New Enterprise Mode – Maltego-inspired interface with visual graphs and professional workflows.
📢 See what's new

Patreon Web site Facebook YouTube Twitter/X Instagram TryHackMe

☕️ Support the project

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

Buy Me a Coffee

🌞 Subscriptions

Subscribe to: Jey Zeta

Kali Linux

from made in with by: Victor Bancayan

© 2026

api-scraping
cybersecurity
github-search
hackunderway
hudsonrock
infosec
osint
osint-tool
phone-number
phoneosint
python
searchphone

HackUnderway/SearchPhone

Phone number OSINT toolkit with multi-API search (Google, GitHub, Numverify, Reddit, DuckDuckGo), Hudson Rock infostealer intelligence, and automatic report generation.

Python

2,037

13 commits

updated Aug 24, 2026

See the code

README

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. 👁

SearchPhone

Python version License

✨ Features

  • 📱 Phone Number Validation - Validates and formats phone numbers using phonenumbers library
  • 🔍 Multiple Search Engines - Searches Google (via SerpAPI) and DuckDuckGo
  • 💻 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
  • 🛡️ Infostealer Intelligence - Checks if a phone number has been compromised by info-stealer malware via Hudson Rock Cavalier API (free, no API key required)
  • 📄 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:

ServicePurposeLinkPlanKey
NumverifyPhone number validation & carrier infonumverify.comFree (100 requests/month)🔑 (Necessary)
SerpAPIGoogle Search resultsserpapi.comFree (250 searches/month)🔑 (Necessary)
GitHub TokenGitHub code searchGitHub SettingsFree (5000 requests/hour)🔑 (Necessary)
Hudson RockInfostealer intelligencecavalier.hudsonrock.comFree (No API key required)❌ No key needed

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

SearchPhone

SearchPhone

The project is open to partners.

SUPPORTED DISTRIBUTIONS

DistributionVerified versionSupportedStatus
Kali Linux2026.2✅Working
Parrot Security OS6.3✅Working
Windows11✅Working
BackBox9✅Working
Arch Linux2024.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 : [email protected]

LICENSE

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

👨‍💻 Author


🕵️‍♂️ OSINT Platform

OSINT Platform

Automate OSINT processes
New Enterprise Mode – Maltego-inspired interface with visual graphs and professional workflows.
📢 See what's new

Patreon Web site Facebook YouTube Twitter/X Instagram TryHackMe

☕️ Support the project

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

Buy Me a Coffee

🌞 Subscriptions

Subscribe to: Jey Zeta

Kali Linux

from made in with by: Victor Bancayan

© 2026

api-scraping
cybersecurity
github-search
hackunderway
hudsonrock
infosec
osint
osint-tool
phone-number
phoneosint
python
searchphone

Significant stargazers

Patricio Gonzalez Vivo

4,329 followers · starred Jun 2026

Stéphane Wirtel

224 followers · starred Aug 2026

William Allen

122 followers · starred Aug 2026

khashashin

59 followers · starred Aug 2026